mcp declaration defines a named MCP server connection used by imports.
mcp namespace.
Authenticated MCP servers
Useheaders {} when the MCP server requires authentication or request-scoped metadata.
secrets and input.
Practical guidance
- Keep one
mcpdeclaration per backend capability domain (tasks,knowledge,crm). - Pass credentials through
secrets, never hardcode long-lived tokens. - Add request-scoped headers (workspace, tenant, user context) when your MCP backend needs routing context.
- Keep endpoint URLs stable and move environment-specific values to deployment configuration.
.wire files. Pass them through secrets.