anthropic · Anthropic Claude Docs
Claude MCP connector
Teaches how to integrate remote Model Context Protocol (MCP) servers directly into the Messages API by configuring server definitions and toolsets.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Claude MCP connector
Teaches how to integrate remote Model Context Protocol (MCP) servers directly into the Messages API by configuring server definitions and toolsets.
When To Use
Use when you need to connect an AI agent to remote MCP tools via the Messages API without implementing a separate MCP client.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/claude-mcp-connector-workflow-guide.md | Documentation explaining how to connect to remote MCP servers directly via the Messages API using the anthropic-beta header. | Questions about documentation explaining how to connect to remote MCP servers directly via the Messages API using the anthropic-beta... |
examples/claude-mcp-connector-curl-request.bash | A curl command demonstrating how to send a messages API request with the mcp-client-2025-11-20 beta header and mcp-servers configuration. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to send a messages API request with the mcp-client-2025-11-20 beta header and mcp-se... |
examples/claude-mcp-connector-bash-messages-create.bash | A bash command demonstrating how to use the anthropic CLI to create a message with an integrated MCP server via a YAML payload. | Exact payloads, commands, or snippets shown in A bash command demonstrating how to use the anthropic CLI to create a message with an integrated MCP server via a YAM... |
examples/claude-mcp-connector-python-client-implementation.python | A Python code example demonstrating how to initialize an Anthropic client with an MCP server via a URL and authorization token. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to initialize an Anthropic client with an MCP server via a URL and authorizat... |
examples/claude-mcp-connector-typescript-client-implementation.typescript | A TypeScript code example demonstrating how to initialize the Anthropic SDK with an MCP server configuration using the SSE protocol. | Exact payloads, commands, or snippets shown in A TypeScript code example demonstrating how to initialize the Anthropic SDK with an MCP server configuration using th... |
examples/claude-mcp-connector.csharp | A C# code example demonstrating how to initialize an Anthropic client and interact with MCP servers using the Claude MCP connector. | Exact payloads, commands, or snippets shown in A C# code example demonstrating how to initialize an Anthropic client and interact with MCP servers using the Claude... |
examples/claude-mcp-connector-go-client-implementation.go | A Go implementation demonstrating how to initialize an Anthropic client to interact with the Claude MCP connector. | Exact payloads, commands, or snippets shown in A Go implementation demonstrating how to initialize an Anthropic client to interact with the Claude MCP connector. |
examples/claude-mcp-connector-java-client-setup.java | A Java code example demonstrating how to initialize an Anthropic client and connect to an MCP server via an SSE URL. | Exact payloads, commands, or snippets shown in A Java code example demonstrating how to initialize an Anthropic client and connect to an MCP server via an SSE URL. |
examples/claude-mcp-connector-php-client-implementation.php | A PHP code example demonstrating how to initialize the Anthropic client with an MCP server configuration using the SSE protocol. | Exact payloads, commands, or snippets shown in A PHP code example demonstrating how to initialize the Anthropic client with an MCP server configuration using the SS... |
examples/claude-mcp-connector-ruby-client-implementation.ruby | A Ruby code example demonstrating how to initialize an Anthropic client with an MCP server configuration using the SSE protocol. | Exact payloads, commands, or snippets shown in A Ruby code example demonstrating how to initialize an Anthropic client with an MCP server configuration using the SS... |
examples/claude-mcp-connector-configuration.json | A JSON configuration object defining the connection settings and authorization for a Claude MCP connector server. | Exact payloads, commands, or snippets shown in A JSON configuration object defining the connection settings and authorization for a Claude MCP connector server. |
examples/claude-mcp-connector-configuration-2.json | A JSON configuration object defining an MCP toolset, server name, and specific tool loading settings for the Claude MCP connector. | Exact payloads, commands, or snippets shown in A JSON configuration object defining an MCP toolset, server name, and specific tool loading settings for the Claude M... |
examples/claude-mcp-connector-google-calendar-config.json | A JSON configuration object defining a Google Calendar MCP server toolset for the Claude MCP connector. | Exact payloads, commands, or snippets shown in A JSON configuration object defining a Google Calendar MCP server toolset for the Claude MCP connector. |
examples/claude-mcp-connector-json-configuration.json | A JSON configuration object defining an MCP toolset for a Google Calendar MCP server. | Exact payloads, commands, or snippets shown in A JSON configuration object defining an MCP toolset for a Google Calendar MCP server. |
examples/claude-mcp-connector-google-calendar-config-2.json | A JSON configuration object defining the enabled tools and settings for the Google Calendar MCP server within the Claude MCP connector. | Exact payloads, commands, or snippets shown in A JSON configuration object defining the enabled tools and settings for the Google Calendar MCP server within the Cla... |
examples/claude-mcp-connector-google-calendar-config-3.json | A JSON configuration object defining the mcptoolset and server settings for a Google Calendar MCP connector. | Exact payloads, commands, or snippets shown in A JSON configuration object defining the mcptoolset and server settings for a Google Calendar MCP connector. |
examples/claude-mcp-connector-google-calendar-config-4.json | A JSON configuration object defining the enabled tools and loading behavior for a Google Calendar MCP server within the Claude MCP connector. | Exact payloads, commands, or snippets shown in A JSON configuration object defining the enabled tools and loading behavior for a Google Calendar MCP server within t... |
examples/claude-mcp-connector-tool-use-event.json | A JSON object representing a Claude MCP connector tool use event containing server name and input parameters. | Exact payloads, commands, or snippets shown in A JSON object representing a Claude MCP connector tool use event containing server name and input parameters. |
examples/claude-mcp-connector-tool-result.json | A JSON object demonstrating the structure of an MCP tool result response within the Claude MCP connector. | Exact payloads, commands, or snippets shown in A JSON object demonstrating the structure of an MCP tool result response within the Claude MCP connector. |
examples/claude-mcp-connector-configuration-3.json | A JSON configuration object defining multiple MCP servers via SSE URLs and authorization tokens for use with the Claude MCP connector. | Exact payloads, commands, or snippets shown in A JSON configuration object defining multiple MCP servers via SSE URLs and authorization tokens for use with the Clau... |
examples/claude-mcp-connector-inspector-npx-command.bash | A bash command to run the Model Context Protocol inspector using npx for the Claude MCP connector. | Exact payloads, commands, or snippets shown in A bash command to run the Model Context Protocol inspector using npx for the Claude MCP connector. |
examples/claude-mcp-connector-configuration-4.json | A JSON configuration object defining an MCP server connection using an SSE URL and an authorization token. | Exact payloads, commands, or snippets shown in A JSON configuration object defining an MCP server connection using an SSE URL and an authorization token. |
examples/claude-mcp-connector-npm-install-command.bash | The bash command to install the Anthropic SDK and the Model Context Protocol SDK via npm. | Exact payloads, commands, or snippets shown in The bash command to install the Anthropic SDK and the Model Context Protocol SDK via npm. |
examples/claude-mcp-connector.typescript | A TypeScript code example demonstrating how to implement the Claude MCP connector. | Exact payloads, commands, or snippets shown in A TypeScript code example demonstrating how to implement the Claude MCP connector. |
examples/claude-mcp-connector-typescript-stdio-client-setup.typescript | A TypeScript example demonstrating how to initialize an MCP client using StdioClientTransport to connect to an MCP server and list available tools. | Exact payloads, commands, or snippets shown in A TypeScript example demonstrating how to initialize an MCP client using StdioClientTransport to connect to an MCP se... |
examples/claude-mcp-connector-typescript-implementation.typescript | A TypeScript code example demonstrating how to use the mcpMessages helper to integrate MCP prompt responses into a Claude messages API request. | Exact payloads, commands, or snippets shown in A TypeScript code example demonstrating how to use the mcpMessages helper to integrate MCP prompt responses into a Cl... |
examples/claude-mcp-connector-typescript-resource-to.typescript | A TypeScript example demonstrating how to use mcpResourceToContent and mcpResourceToFile helpers to convert MCP resources into message content blocks. | Exact payloads, commands, or snippets shown in A TypeScript example demonstrating how to use mcpResourceToContent and mcpResourceToFile helpers to convert MCP resou... |
examples/claude-mcp-connector-configuration-5.json | A JSON configuration object defining MCP server connection details, including URL, authentication tokens, and tool permissions. | Exact payloads, commands, or snippets shown in A JSON configuration object defining MCP server connection details, including URL, authentication tokens, and tool pe... |
examples/claude-mcp-connector-configuration-6.json | A JSON configuration object defining MCP server connections and toolset settings for the Claude MCP connector. | Exact payloads, commands, or snippets shown in A JSON configuration object defining MCP server connections and toolset settings for the Claude MCP connector. |
examples/claude-mcp-connector-configuration-7.json | A JSON configuration object defining MCP server connection details including URL, authorization tokens, and tool permissions. | Exact payloads, commands, or snippets shown in A JSON configuration object defining MCP server connection details including URL, authorization tokens, and tool perm... |
What This Skill Covers
- -------|------|----------|-------------| | type | string | Yes | Currently only "url" is supported. | | url | string | Yes | The URL of the MCP server. Must...
- Main sections:
Key features,Limitations,Using the MCP connector in the Messages API,Basic example,MCP server configuration.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector