Cline 远程 MCP 鉴权：踩坑与最佳实践-编程实验室

最近在折腾 MCP Server，遇到个特别抓狂的问题。

本地开发一切顺利，GitHub Token 塞进.env环境变量里就完事了，Cline (VS Code 插件) 跑得飞起。但当我把 Server 部署到服务器上，想让团队里每个人用自己的 GitHub Token去跑任务时，傻眼了…

Cline 的配置里好像没地方填“动态参数”？难道要每个人都去改 Server 的环境变量？这也太不安全了。

折腾了一晚上，终于摸索出了一套基于 HTTP Header 和 ContextVars 的透传方案。

痛点：如何把 Token 传过去？

我们面临的死局是：

MCP 协议：主要是 JSON-RPC，标准里好像没规定怎么传鉴权 Token。
Cline 客户端：配置项少得可怜，只有command(本地) 和url(远程)。

但我转念一想，MCP 的 SSE 模式本质上就是 HTTP 长连接。既然是 HTTP，Header 总能用吧？

验证时刻：Cline 真的发 Header 吗？

虽然 Cline 文档里没明说支持自定义 Header，写了个简单的“抓包脚本”来验证。

Header Sniffer 脚本 (src/header_sniffer.py)：

fromaiohttpimportwebasyncdefhandle_all(request):print("\n[Request Received]")print("--- Headers ---")forname,valueinrequest.headers.items():print(f"{name}:{value}")print("---------------")# 返回一个假的 SSE 响应防止客户端报错returnweb.Response(text="OK")if__name__=="__main__":app=web.Application()app.router.add_route('*','/{tail:.*}',handle_all)print("Sniffer running on port 13334...")web.run_app(app,port=13334)

验证过程：

启动这个脚本：python src/header_sniffer.py

在 Cline 的配置里填入：

"url":"http://127.0.0.1:13334/sse","headers":{"X-Github-Token":"test-token-123"}

点击连接。

结果：终端里清晰地跳出了：
X-Github-Token: test-token-123

激动了！Cline 的底层实现是完整的，它默默支持着 Header 发送。这就好办了，路通了。

Server 端接招：从 FastMCP 到 FastAPI

路通了，但 Server 端怎么收呢？

我用的是fastmcp库，它封装得太好了，以至于我找不到地方插 Middleware 去拦截 Header。翻了半天源码，发现FastMCP类其实是一个独立的 Server，不开放底层接口。

破局思路：既然改不了它，就包装它。

FastMCP虽然高冷，但它提供了一个sse_app()方法，返回的是一个标准的 ASGI 应用。这就意味着，我可以用FastAPI做外壳，负责处理 HTTP Header 和鉴权，然后把“脏活累活”甩给 FastMCP 去干。

核心代码实现

直接上干货。我们需要用到 Python 的contextvars，这玩意儿是处理并发请求的神器，比 ThreadLocal 更好用。

fromcontextvarsimportContextVarfromfastapiimportFastAPI,RequestfromfastmcpimportFastMCPimportuvicorn# 1. 定义一个“隐形口袋” (ContextVar)# 用来在请求处理过程中临时存放 Token，请求结束自动销毁，并发安全。user_token_ctx=ContextVar("user_token",default=None)# 2. 定义 FastAPI 外壳app=FastAPI()# 3. 编写中间件：拦截 Token 并装进口袋@app.middleware("http")asyncdeftoken_passthrough_middleware(request:Request,call_next):# 只拦截 MCP 相关的 SSE 请求ifrequest.url.path.startswith("/sse")orrequest.url.path.startswith("/messages"):# 拿到用户传来的 Tokentoken=request.headers.get("X-Github-Token")iftoken:user_token_ctx.set(token)print(f"收到来自{request.client.host}的 Token，已暂存。")response=awaitcall_next(request)returnresponse# 4. FastMCP 核心逻辑mcp=FastMCP("MyServer")@mcp.tool()asyncdeflist_repos():# 5. 在工具里从口袋掏出 Tokentoken=user_token_ctx.get()iftoken:print("Using Client-Provided Token!")# 这里就可以用用户的 Token 去调 GitHub API 了client=GitHubClient(token=token)else:print("Fallback to Server Token...")client=GitHubClient(token=os.getenv("GITHUB_TOKEN"))returnclient.get_repos()# 6. 关键一步：把 FastMCP 挂载上去mcp_app=mcp.sse_app()app.mount("/",mcp_app)if__name__=="__main__":# 启动的是 FastAPI，而不是 mcp.run()uvicorn.run(app,host="0.0.0.0",port=13333)

客户端配置 (Cline)

Server 端改好后，Cline 这边的配置就非常简单直观了：

{"mcpServers":{"my-remote-server":{"url":"http://192.168.1.100:13333/sse","transport":"sse","headers":{"X-Github-Token":"ghp_这就是每个用户自己的Token"},"autoApprove":[]}}}