使用说明

正常运转

要在本地运行此程序，请执行以下操作：

启动Cloudflare测试隧道： cloudflared tunnel --url http://localhost:4000
将隧道主机复制到 @tunnel 在……里面 McpController.
mix phx.server

这应该让一切准备就绪。然后转到https://claude.ai“管理连接器”并添加一个自定义连接器。使用附带的Cloudflare URL "/mcp" 随便你怎么命名。之后点击“连接”，它应该可用。你可以让它使用该工具，并给出“谁是最好的”这样的提示名字以“blah”开头的人。

远程MCP服务器认证实践

你在SaaS工作，高级领导说你必须把API包装起来每个人都在谈论的新MCP。你几乎肯定读过克劳德呕吐规格我真的不知道该怎么办。这意味着什么？有很多 SHOULDs、terms等，但具体来说，你只想添加你的 SaaS的工具面向流行的客户。此外身份验证规范有很多缺点，但实际上克劳德似乎并不是跟随它。

本文档详细介绍了如何执行远程MCP服务器，特别是与Claude web应用程序客户端。

我将接受任何想详细说明其他客户（在特别是ChatGPT！)在实践中也实现了规范的客户端部分。

此repo也是一个使用此协议的Elixir应用程序。随时部署它或在本地运行，ngrok或cloudflare隧道指向它。

克劳德

基本上，让我们看看实现这一目标需要什么：

假设您将集成放在那里，路径为 /mcp.第一件事当您添加集成时，Anthropic将测试初始化与它的联系：

POST /mcp HTTP/1.1
Accept: application/json, text/event-stream
Accept-Encoding: gzip
Content-Type: application/json

{
  "method": "initialize", 
  "params": {
    "protocolVersion": "2024-11-05", 
    "capabilities": {}, 
    "clientInfo": {
      "name": "claude-ai", 
      "version": "0.1.0"
    }
  }, 
  "jsonrpc": "2.0",
  "id": 0
}

由于请求尚未通过身份验证，我们可以用401和根据规范一告诉Claude在哪里找到oauth-protected-resources的特定标头元数据。

HTTP/1.1 401 Unauthorized
Www-Authenticate: Bearer resource_metadata=https://garbage-actress-light-legislature.trycloudflare.com/.well-known/oauth-protected-resource

GET /mcp
Accept: text/event-stream

我们可以用同样的401来回应。

此时，克劳德很满意，不会再发出任何请求，直到你尝试连接：

根据此图表

然后它应该打电话给那个人 oauth-protected-resource 端点在401标头中返回，并查看 authorization_servers 要查找的字段这 /.well-known/oauth-authorization-server 主机，按规格. 然而，我无法让它这样做，相反，它总是只调用我的集成所居住的主机上的路径。

GET /.well-known/oauth-authorization-server HTTP/1.1

它希望收到以下三条数据的响应：

{
  registration_endpoint: "https://some_host.com/register_oauth_client",
  authorization_endpoint: "https://some_host.com/authorize_oauth_client",
  token_endpoint: "https://some_host.com/oauth_token"
}

然后，它将POST到该端点，通过OAuth DCR注册客户端。

POST /register_oauth_client HTTP/1.1

{
  client_name: "claudeai",
  grant_types: [
    "authorization_code",
    "refresh_token"
  ],
  redirect_uris: [
    "https://claude.ai/api/mcp/auth_callback"
  ],
  response_types: [
    "code"
  ],
  scope: "claudeai",
  token_endpoint_auth_method: "none"
}

这应该按照 RFC 7591.注意请求指定 token_endpoint_auth_method: "none"，暗示它不会发送 client_secret 关于后者 /token 电话。我尝试了各种答案，如包括 client_secret 以及一个值 token_endpoint_auth_method 属于的 client_secret_post，但找不到克劳德稍后再透露这个秘密。因此，我们应该将其视为公共客户，而不是机密客户。后面的请求确实使用了PKCE。

我还尝试返回不同的范围，但它们被忽略了。克劳德坚持使用自己 claudeai 范围。

所以我们只需要用一个 client_id.

HTTP/1.1 201 Created

{
  "client_id": "public-client-id-for-claude"
}

请注意，此时 Claude为给定的集成保存此客户端领域。如果您使用web界面删除客户端，然后尝试添加再次，它不会使 register 再次呼叫。

在这一点上，它是一个标准的3标签授权代码授予OAuth流，用于使用PKCE的公共客户端。

Claude将用户的浏览器重定向到授权端点，并使用 state param，PKCE，以及 client_id 早些时候返回：

GET /authorize_oauth_client?....

以下是包含的查询参数（为便于阅读，此处列出）：

"client_id": "claude-ai-oauth-client"
"code_challenge": "<PKCE challenge>"
"code_challenge_method": "S256"
"redirect_uri": "https://claude.ai/api/mcp/auth_callback"
"response_type": "code"
"scope": "claudeai"
"state": "<state value>"

我们进行授权并重定向回Claude的：

HTTP/1.1 302 Found
Location: https://claude.ai/api/mcp/auth_callback?state=<state>&code=code-for-claude

最后克劳德得到一个令牌：

POST /oauth_token HTTP/1.1

{  
  "client_id": "claude-ai-oauth-client", 
  "code": "code-for-claude", 
  "code_verifier": "PKCE Stuff",
  "grant_type": "authorization_code", 
  "redirect_uri": "https://claude.ai/api/mcp/auth_callback"
}

我们返回OAuth令牌：

HTTP/1.1 201 Created

{
  "access_token": "access-token-for-claude",
  "refresh_token": "refresh-token-for-claude",
  "expires_in": 6000
}

最后克劳德又试了一次 POST 走向整合之路初始化，但这次包括它的令牌！

POST /mcp
Authorization: Bearer access-token-for-claude

{
  "method": "initialize", 
  "params": {
    "protocolVersion": "2024-11-05", 
    "capabilities": {}, 
    "clientInfo": {
      "name": "claude-ai", 
      "version": "0.1.0"
    }
  }, 
  "jsonrpc": "2.0",
  "id": 0
}

现在似乎每个人都在谈论“工具”，所以我们可能想对此做出回应。只是说说而已 "tools": {} 表示工具能力。具体工具将来自后续请求。这我们能够应对的能力是明确的这里

HTTP 200 OK
Mcp-Session-Id: "some-session-id"

{ 
  "jsonrpc": "2.0", 
  "id": 0, 
  "result": {
    "protocolVersion": "2025-03-26", 
    "capabilities": { 
      "tools": {} 
    }, 
    "serverInfo": { 
      "name": "My Test Server", 
      "version": "1.0.0" 
    }
  }
}

注： id 必须与请求匹配，并且 protocolVersion 必须匹配（请注意，Claude web应用程序使用旧版本的协议）。

虽然规范上说你“可以”建立一个 Mcp-Session-Id，克劳德应用程序需要它。如果你不提供，它就不会继续请求工具和其他能力。

此外，无论你在这里用什么能力来回应，似乎克劳德应用程序总是请求 tools/list, prompts/list，以及 resources/list.

克劳德很高兴，初始化并发送：

POST /mcp

{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}

接下来是获取工具的请求。

POST /mcp

{
  "id": 1, 
  "jsonrpc": "2.0", 
  "method": "tools/list", 
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "Best Person Looker-upper",
        "description": "Helps the agent identify who the best person is.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "startsWith": {"type": "string"}
          },
          "required": ["startsWith"]
        }
      }
    ]
  }
}

工具架构为这里.

请注意，克劳德似乎保存将这些工具提供给给定的客户端（MCP主机/ 地址也许？).如果你稍后更改它们，当你重新连接时，它不会重新访问他们。

使用说明

正常运转

远程MCP服务器认证实践

克劳德

相关 MCP

实时网络搜索服务

Blender 3D建模MCP服务

iOS模拟器交互服务器

图像生成服务

滴滴出行MCP服务

网页抓取与搜索MCP服务器