MCP 接入

平台不替客户端拉起 MCP Server，只把「写侧包现在的状态」和「可直接粘贴的客户端配置」摆在这里。把 JSON 复制到你的 agent 客户端就能连上。

mcp-crm 是写侧：客户端把聊天记录交给平台，由智能体抽取联系人、公司与字段并建档。

默认 stdio 传输，无需开放端口；只有远程客户端接入时才用 Streamable HTTP。

平台侧写入同时提供 HTTP 入口 POST /api/intake，供不方便装 MCP 客户端的场景直连。

HTTP 模式只绑定 127.0.0.1。要对公网暴露必须先前置反向代理并加认证。

mcp-crm 写

还需处理

客户端把聊天记录原文交给平台：调 import_wechat_chat 转发到 /api/intake，由平台侧智能体抽取联系人、公司与字段并建档。本包不解析、不改写、不落盘。

尚未编译：先在该目录执行 bun install 与 bun run build，产出 dist/index.js。

未配置 CRM_BASE_URL，服务启动会直接以非零码退出。

在该目录下执行：

cd "/www/wwwroot/prm/mcp-crm"
bun install
bun run build

配置项

CRM_BASE_URL必填

http://127.0.0.1:3100

CRM 平台地址，正常情况下就是本平台。来源：未配置

CRM_MAX_TEXT_LENGTH可选

未配置

单次转发的聊天记录字符上限，默认 50000，超限会被拒绝并要求分批。来源：未配置

MCP_HTTP_PORT可选

未配置

留空 = 只用 stdio（推荐）。填端口后改为 Streamable HTTP，只绑定 127.0.0.1。来源：未配置

提供的工具

import_wechat_chat把一段聊天记录原样转发给平台，返回新建的联系人与公司。

intake_status探测平台是否在线、智能体是否可用。写入失败前先调它定位问题。

客户端配置（复制即用）

stdio 模式（推荐）

通用 mcpServers 结构：Cursor 的 .cursor/mcp.json（或 ~/.cursor/mcp.json）、WorkBuddy 的连接器配置、Claude Desktop 的 %APPDATA%\Claude\claude_desktop_config.json 都填这一段。

{
  "mcpServers": {
    "crm": {
      "command": "node",
      "args": [
        "/www/wwwroot/prm/mcp-crm/dist/index.js"
      ],
      "env": {
        "CRM_BASE_URL": "http://127.0.0.1:3100"
      }
    }
  }
}

Streamable HTTP 模式（先用 MCP_HTTP_PORT=3940 node dist/index.js 起服务）

客户端只支持远程连接时用这一段；服务只监听 127.0.0.1。

{
  "mcpServers": {
    "crm": {
      "type": "http",
      "url": "http://127.0.0.1:3940/mcp"
    }
  }
}

入口文件：/www/wwwroot/prm/mcp-crm/dist/index.js未编译

配置文件：/www/wwwroot/prm/mcp-crm/.env未创建

不装 MCP 客户端也能写入

MCP 是可选的接入方式。任何能发 HTTP 请求的脚本都可以直接调平台的 POST http://127.0.0.1:3100/api/intake，走的是同一条智能体抽取链路，效果与 mcp-crm 的 import_wechat_chat 完全一致。