Set up Copilot Studio
Microsoft’s low-code agent builder. Connect Agentcy as an MCP tool so your Copilot Studio agents — and Microsoft 365 Copilot — can query marketing data across your organization.
Documented but not yet end-to-end verified
Copilot Studio requires Generative Orchestration enabled at the agent level, enterprise Power Platform licensing, and each MCP tool call consumes Copilot Credits per invocation — not free for production. We’ve followed Microsoft’s official docs carefully but haven’t confirmed Agentcy works in a real Copilot Studio agent yet, and Microsoft’s docs are ambiguous on whether the API key field needs the ‘Bearer ’ prefix or just the bare key. Your tenant may also block external connections via DLP policy.
If you successfully install Agentcy here, so we can mark it verified — and if you hit issues, please tell us what you saw.
- 01
Sign up at app.goagentcy.com and create an API key
- 02
Open your agent in Microsoft Copilot Studio (copilotstudio.microsoft.com)
- 03
PREREQUISITE: Settings → Generative AI → Orchestration — confirm Generative Orchestration is ENABLED. Without it, MCP setup completes but no tools activate at runtime. If your tenant blocks Generative AI features, your Power Platform admin must enable them first.
- 04
Go to Tools in the agent left nav. Click + Add a tool → + New tool → Model Context Protocol
- 05
Server name: Agentcy | Description: Marketing intelligence MCP server
- 06
Server URL: https://data.goagentcy.com/mcp
- 07
Authentication: API key | Type: Header | Header name: Authorization
- 08
Click Create → Create a new connection
- 09
Enter your agcy_... API key. NOTE: Microsoft's docs are ambiguous about the Bearer prefix. If authentication fails, retry with the full string: Bearer agcy_YOUR_KEY_HERE (with the word ‘Bearer’ and a space)
- 10
Click Add to agent. Publish and test.
path: Tools → Add a tool → New tool → Model Context Protocol
# Copilot Studio is a UI flow — no file-based config.
# Settings live in your agent's Tools tab. Steps:
# PREREQUISITE — verify Generative Orchestration is enabled
# Settings > Generative AI > Orchestration
# (Without it, MCP setup completes but no tools activate at runtime.
# If your tenant blocks Generative AI features at the environment
# level, your Power Platform admin must enable them first.)
# 1. Open your agent in Copilot Studio
# 2. Tools > + Add a tool > + New tool > Model Context Protocol
# 3. Server name: Agentcy
# Server description: Marketing intelligence MCP server
# Server URL: https://data.goagentcy.com/mcp
# 4. Auth: API key | Type: Header | Header name: Authorization
# 5. Click Create > Create a new connection
# 6. API key value: enter your agcy_... key
# (Microsoft's docs are ambiguous about whether to include the
# "Bearer " prefix. If your connection fails authentication, try
# entering the full string: Bearer agcy_YOUR_KEY_HERE)
# 7. Click Add to agent. Publish.Copilot Studio gotchas (read these before debugging anything else): (1) Generative Orchestration MUST be enabled on the agent for MCP tools to work. The toggle is at Settings → Generative AI → Orchestration. This is the silent killer — setup will appear to succeed but no tools activate at runtime. (2) Some enterprise tenants block Generative AI features at the environment level via Power Platform Admin Center; if you can’t toggle Orchestration on, your tenant admin needs to enable Generative AI for the environment first. (3) DLP policies may block external connections to data.goagentcy.com — admin must add it to the allowlist. (4) Microsoft’s docs are ambiguous about whether the API Key field should contain the bare key or the full ‘Bearer agcy_...’ string with prefix — we couldn’t independently verify which works. If your connection fails authentication, try the full string with ‘Bearer ’ prefix first. (5) Each MCP tool call consumes Copilot Credits (replaced ‘messages’ in September 2025) — not free for production. (6) Streamable HTTP only — SSE was deprecated August 2025.
Stuck or want to verify these instructions yourself? These are the documentation sources we used. If something here doesn't match what you see in your client, the vendor may have updated their UI — and we'll get this page updated.
- Microsoft Learn — Add an existing MCP server to your agent (canonical wizard doc)
- Microsoft Learn — Extend agent with MCP (Generative Orchestration prerequisite)
- Microsoft Learn — Copilot Studio What’s New (changelog through April 7 2026)
- Microsoft Blog — MCP GA in Copilot Studio announcement (May 2025)
After connecting Copilot Studio and configuring your data sources in the portal, ask questions about any of them in natural language: