进阶 / Hooks / MCP

MCP Server 配置完整指南

stdio / SSE / HTTP 三种传输;Auth、超时、scope — 从入门到生产级配置。

Kition 团队·2026年7月26日·8 分钟阅读

三种传输

  • stdio — 本地子进程,最简单,安全
  • SSE — 服务端推流,适合远程服务
  • HTTP — 标准请求 / 响应,适合无状态服务

一份完整配置

{
  "mcpServers": {
    "github": {
      "transport": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "$GITHUB_TOKEN" },
      "timeout": 30000
    },
    "internal-api": {
      "transport": "http",
      "url": "https://mcp.internal/v1",
      "headers": { "Authorization": "Bearer $INTERNAL_KEY" }
    }
  }
}

生产经验

  • 给每个 server 单独设 timeout
  • `scope` 字段限制可用工具,避免 Agent 误用
  • 远程 MCP 用 mTLS / 短期 Token
  • 把 MCP server 列表纳入 Vault 文档版本控制

下载 Kition

本地优先的 AI 工作空间。Markdown 文档、结构化数据表、AI Agent,全部跑在你自己的电脑上。