yj-mcp 接入帮助

只读业务数据 MCP：CRM、cpt、文档库。主访问地址为 https://mcp.uhome.org.cn（Let's Encrypt TLS）。

← 返回 token 签发

0. 每个用户先获取自己的 token

1. 让管理员把你的 CRM 登录名加入试点 allowlist。
2. 打开 /login，用 CRM 用户名/密码登录。
3. 页面只显示一次 yjm_... token；保存到权限 0600 的文件，例如 ~/.config/yj-mcp/token。
4. 不要把 token 放进 URL、聊天记录或共享配置；每台设备使用自己的 token，丢了就重新登录。

1. 地址与证书

域名使用 Let's Encrypt 证书，浏览器和 MCP 客户端无需额外信任配置。不要设置 NODE_TLS_REJECT_UNAUTHORIZED=0 或关闭 TLS 校验。

2. Claude Code

推荐用项目或个人 .mcp.json，通过环境变量读取 token，不要让 token 出现在命令行参数里：

export YJ_TOKEN="$(cat ~/.config/yj-mcp/token)"

{
  "mcpServers": {
    "yj": {
      "type": "http",
      "url": "https://mcp.uhome.org.cn/mcp",
      "headers": { "Authorization": "Bearer ${YJ_TOKEN}" }
    }
  }
}

如果 Claude Code 版本不支持配置文件里的 ${VAR} 展开，先升级；不要把真实 token 提交到仓库。

3. Codex CLI / IDE

[mcp_servers.yj]
url = "https://mcp.uhome.org.cn/mcp"
bearer_token_env_var = "YJ_TOKEN"

export YJ_TOKEN="$(cat ~/.config/yj-mcp/token)"

Codex 会忽略 headers，必须使用 bearer_token_env_var 或 http_headers。域名证书是公共 CA 证书，无需额外信任。

4. WorkBuddy（腾讯）

~/.workbuddy/mcp.json（或项目级 .workbuddy/mcp.json）：

{
  "mcpServers": {
    "yj": {
      "type": "streamableHttp",
      "url": "https://mcp.uhome.org.cn/mcp",
      "headers": { "Authorization": "Bearer ${YJ_TOKEN}" },
      "timeout": 30000
    }
  }
}

先设置 YJ_TOKEN。不同 WorkBuddy 版本的 ${VAR} 展开可能不同；若不支持，使用该客户端自己的凭据/令牌存储，避免把 token 写进共享文件。域名为受信任证书，无需额外信任配置。

5. 豆包工作版（Doubao Work）

1. 打开「技能 / 连接器 / 伙伴」→「新建」→「新建自定义连接器」。
2. 名称填 yj，传输类型选 HTTP（即 Streamable HTTP），URL 填 https://mcp.uhome.org.cn/mcp。
3. 自定义 Header 填 Authorization: Bearer yjm_...（当前用户自己的 token）。
4. 工作环境选择「工作任务 · 本地电脑」；自定义连接器按当前版本只在本机生效，换设备需重配。
5. 域名证书受信任，无需额外信任配置。

豆包工作版不同版本界面略有差异；如果支持粘贴 mcpServers JSON，可使用与 WorkBuddy 相同的 streamableHttp 配置。

6. Claude Desktop（本地 stdio 桥）

Claude Desktop 的远程连接器只支持 OAuth，不能直接填静态 Bearer。需要在本机运行 Node 24 和本项目构建产物，通过 yj-mcp bridge 连接；token 从 0600 文件读取：

{
  "mcpServers": {
    "yj": {
      "command": "/usr/bin/node",
      "args": [
        "/path/to/yj-mcp/dist/main.js",
        "bridge",
        "--url",
        "https://mcp.uhome.org.cn/mcp"
      ],
      "env": {
        "YJ_TOKEN_FILE": "/Users/you/.config/yj-mcp/token"
      }
    }
  }
}

本项目 package 目前是 private，未发布到 npm，因此不能用 npx yj-mcp；需要先复制仓库到本机并 npm ci --ignore-scripts && npm run build，或后续打包单文件二进制。token 文件必须 0600。

7. Pi

当前安装的 Pi coding agent 不内置 MCP 客户端（其 README 明确写明 “No MCP”）。Pi 不能直接填这个 URL 接入；需要额外开发 Pi extension，或改用 CLI/skill 封装。当前 v1 没有现成的 Pi 适配。

8. 其他 Streamable HTTP MCP 客户端

POST https://mcp.uhome.org.cn/mcp
Authorization: Bearer yjm_...
Content-Type: application/json
Accept: application/json, text/event-stream

每个用户必须先在自己的浏览器页面登录获取 token，不要共用管理员或其他人的 token。MCP 返回纯 JSON 文本工具结果，不返回 structuredContent。

常见错误