mcp-connector changedagents-and-tools/mcp-connector
Recorded here
Lines+76added
Lines−4removed
From line
4
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits42to this page, all time
## Availability ### API support #### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) #### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) ### Required beta headers ### Data handling
The whole hunk
from line 4, old and new numbered
/
from line 4
44description: Connect to remote MCP servers directly from the Messages API without an MCP client, and allowlist, denylist, or configure individual tools.
55featureMetadata:
66 status: beta
7 betaHeader: mcp-client-2025-11-20
8 zdr: not-eligible
7 betaHeader: mcp-client-2026-09-15, mcp-client-2025-11-20
8 zdr:
9 eligibility: not-eligible
10 note: Data retained according to standard policy.
11 supportedModels:
12 - claude-fable-5-1
13 - claude-mythos-5-1
14 - claude-fable-5
15 - claude-mythos-5
16 - claude-mythos-preview
17 - claude-opus-5-5
18 - claude-opus-5
19 - claude-sonnet-5-5
20 - claude-sonnet-5
21 - claude-haiku-5-5
22 - claude-haiku-4-5-20251001
23 - claude-opus-4-8
24 - claude-opus-4-7
25 - claude-opus-4-6
26 - claude-sonnet-4-6
27 - claude-opus-4-5-20251101
28 - claude-sonnet-4-5-20250929
929 supportedPlatforms:
1030 Claude API: beta
1131 Claude Platform on AWS: beta
32 Claude Models on Google Cloud (Anthropic managed): beta
1233 Microsoft Foundry: beta
1334---
1435
36**API support**: Usage differs by product.
37
38* **Messages API**: Pass `mcp_servers` and a matching `mcp_toolset` in `tools` on each request.
39* **Managed Agents**: Declare MCP servers on the agent. Each session supplies credentials by referencing a vault, so secrets stay out of the agent definition.
40
1541Claude’s Model Context Protocol (MCP) connector feature allows you to connect to remote MCP servers directly from the Messages API without a separate MCP client.
1642
1743<Note>
from line 2014
19882014
19892015The MCP connector is not covered by ZDR arrangements. Data exchanged with MCP servers, including tool definitions and execution results, is retained according to Anthropic’s standard data retention policy.
19902016
1991For ZDR eligibility across all features, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
1992
19932017## Migration guide
19942018
19952019If you’re using the deprecated `mcp-client-2025-04-04` beta header, follow this guide to migrate to the new version.
from line 2127
21032127| `tool_configuration` | object | **Deprecated:** Use MCPToolset in the `tools` array instead |
21042128| `tool_configuration.enabled` | boolean | **Deprecated:** Use `default_config.enabled` in MCPToolset |
21052129| `tool_configuration.allowed_tools` | array | **Deprecated:** Use allowlist pattern with `configs` in MCPToolset |
2130
2131## Availability
2132
2133MCP connector is in beta on every model.
2134
2135### API support
2136
2137#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
2138
2139* Availability: Available
2140* Usage: Pass `mcp_servers` and a matching `mcp_toolset` in `tools` on each request. For OAuth servers you get and refresh the access token yourself and pass it as `authorization_token`.
2141
2142| Status | Cloud platforms |
2143| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2144| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
2145
2146#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
2147
2148* Availability: Available
2149* Usage: Declare MCP servers on the agent. Each session supplies credentials by referencing a vault, so secrets stay out of the agent definition.
2150
2151| Status | Cloud platforms |
2152| ------ | ----------------------- |
2153| Beta | All supported platforms |
2154
2155### Required beta headers
2156
2157[Beta headers overview](https://platform.claude.com/docs/en/api/beta-headers)
2158
2159Beta headers allow you to access experimental features and new model capabilities before they become part of the standard API.
2160
2161| Header | APIs | Cloud platforms |
2162| -------------------------------------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2163| `mcp-client-2026-09-15` or `mcp-client-2025-11-20` | [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) | Claude API |
2164| `mcp-client-2025-11-20` | [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) | [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
2165
2166### Data handling
2167
2168[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
2169
2170| Item | Zero data retention | HIPAA |
2171| ------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
2172| Status | Not eligible | Not eligible |
2173| Details | Data retained according to standard policy. [Learn more](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector#data-retention) | — |
2174
2175Applicable endpoints:
2176
2177* `/v1/messages` with `mcp_servers`
21062178
No line in this hunk matches that.