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 |
Identity headers only work for authenticated users. Set up Identity Verification first.
Managing Your Server
- Sync Tools — Re-discover tools after updating your server
- Enable/Disable Tools — Toggle individual tools in Actions
- Edit — Change URL, transport, or headers
- Delete — Remove the connection entirely
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
Authentication
Service keys, identity headers, and the full auth chain