Connect Your MCP Server

Don’t have an MCP server yet? Use Envoy to auto-generate one from your codebase in minutes — no MCP knowledge needed.

Connect in Dashboard

Go to Integration → Server-Side Tools

Enter your server details:

Field	Description	Example
Name	Display name	`my-backend`
URL	Your MCP server endpoint	`https://mcp.yourapp.com/mcp`
Transport	Streamable HTTP (recommended) or SSE	Streamable HTTP
Headers	Optional auth headers	`Authorization: Bearer sk-...`

Click Test Connection — Crow will connect and discover your tools

Click Save

Go to Actions to enable the tools you want the agent to use

Identity Headers

Forward end-user identity to your MCP server so tools can return user-specific data.

Under Header Mappings, add mappings like:

Header	Source	What gets sent
`X-User-ID`	`identity.user_id`	The logged-in user’s ID
`X-Tenant-ID`	`identity.tenant_id`	Custom claim from your identity JWT

Crow resolves these from the user’s identity token and sends them as HTTP headers on every request to your MCP server.

Identity headers only work for authenticated users. Set up Identity Verification first.

For the full auth chain (service keys, identity forwarding, backend middleware), see Server-Side MCP Authentication.

Troubleshooting

Issue	Solution
Connection failed	Verify URL is reachable, check transport type matches your server
Tools not appearing	Click Sync Tools, check server logs
Agent not using tools	Enable tools in Actions, make sure tool descriptions are clear
401 errors	Check auth headers, see Authentication guide
Timeout	Ensure your MCP server responds within 10 seconds

Envoy CLI

Auto-generate an MCP server from your code

Service keys, identity headers, and the full auth chain