创建一个识别识别的MCP服务器运行在您的私有Tailscale网络（Tailnet）内。本示例利用了传递给运行在tailscale serve后方的应用程序的身份头部。

以此为起点，你可以创建具备身份感知能力（能够访问登录用户邮箱）并代表用户访问内部API或服务的MCP服务器。

说明

启动服务器

1. 如果你还没有Tailnet设置，你需要注册一个。
2. 创建一个API认证密钥，并将其保存在本项目根目录中的.env文件中，格式为：TS_AUTHKEY=tskey-auth-...
3. 已安装 Docker 后，运行 docker compose up 启动服务器。

这将启动两个容器。MCP服务器和运行tailscale serve的Tailscale容器作为你的tailnet代理。

使用服务器

如果你有一个支持直接访问流式HTTP MCP服务器的MCP客户端，那么你应该可以通过指向https://ts-mcp-echo.yourtailnetname.ts.net/mcp来连接服务器。

克劳德桌面

Identity Aware MCP Server for Tailscale

Create an identiy aware MCP server that runs inside your private Tailscale network (Tailnet). This example leverages identity headers that are passed through to applications running behind tailscale serve.

Using this as starting point you can create MCP servers that are identity aware (with access to the logged in user’s email) and can access internal APIs or services on thier behalf.

Instructions

Starting the Server

1. If you don’t already have a Tailnet setup you’ll need to signup for one.
2. Create an API auth key and save it into a .env file in the root of this project with the following format: TS_AUTHKEY=tskey-auth-...
3. With Docker already installed, run docker compose up to start the server.

This will spin up two containers. The MCP server and a Tailscale container running tailscale serve as a proxy to your tailnet.

Using the Server

If you have an MCP Client that supports direct access to Streaming HTTP MCP servers, then you should be able to connect to the server by pointing it to https://ts-mcp-echo.yourtailnetname.ts.net/mcp.

Claude Desktop

Claude desktop does not currently support remote MCP servers (only stdio), but you can use the mcp-remote tool (or any other proxy) to connect to it.

1. Install mcp-remote with npm install -g mcp-remote

2. Add the following configuration to your claude_desktop_config.json file:

       {
           "mcpServers": {
               "tailscale-remote-echo-example": {
                   "command": "npx",
                   "args": [
                       "mcp-remote",
                       "https://ts-mcp-echo.yourtailnetname.ts.net/mcp"
                   ]
               }
           }
       }
   

   You can find your tailnet name by visiting the Tailscale admin console DNS page.

3. Restart Claude Desktop.

4. You should now see a new MCP server called tailscale-remote-echo-example with a greet tool.

5. Ask Claude Who am I logged into my tailnet as? allow the tool, and wait for the response!