yourept-mcp

MCP 服务器，用于接入 CRM YOUREPT。它可以连接到 Claude、Cursor、Codex 及其他 MCP 客户端，让代理能够访问管理后台的数据——线索、学生、教师、课程、付款、结算和财务报表。

它存在的意义就是为了回答这些问题：

“这个月赚了多少，又有多少用于结算？” “哪些线索已逾期，分别属于哪个经理？” “显示一下两周没有上课的学生” “哪些教师还没有在 Рокет Ворк 签署交易？”

也就是说，这些事在界面里需要打开三个板块再手动汇总数字。

安装

1. 获取密钥

在管理后台：设置 → API 密钥 → 创建密钥。密钥只会显示一次——请立即复制。如果丢失，请签发新的，并吊销旧密钥。

密钥以签发它的员工的身份和权限运行：对员工关闭的板块，对代理同样关闭。默认的“只读”密钥实际上无法在 CRM 中更改任何内容。

2. 配置到你的程序中

无需单独安装——npx 会自动下载该包。

该包直接从 GitHub 安装。发布到 npm 后，可以直接写 yourept-mcp，代替 github:Skamatoz/yourept-mcp。

Claude Desktop — 设置 → Developer → Edit Config：

{
  "mcpServers": {
    "yourept": {
      "command": "npx",
      "args": ["-y", "github:Skamatoz/yourept-mcp"],
      "env": {
        "YOUREPT_API_URL": "https://api-admin.yourept.ru",
        "YOUREPT_API_KEY": "yrp_live_ваш_ключ"
      }
    }
  }
}

Claude Code：

claude mcp add yourept \
  --env YOUREPT_API_URL=https://api-admin.yourept.ru \
  --env YOUREPT_API_KEY=yrp_live_ваш_ключ \
  -- npx -y github:Skamatoz/yourept-mcp

Cursor — 文件 ~/.cursor/mcp.json，格式与 Claude Desktop 相同。

Codex — 文件 ~/.codex/config.toml：

[mcp_servers.yourept]
command = "npx"
args = ["-y", "github:Skamatoz/yourept-mcp"]

[mcp_servers.yourept.env]
YOUREPT_API_URL = "https://api-admin.yourept.ru"
YOUREPT_API_KEY = "yrp_live_ваш_ключ"

修改配置后，需要重启程序。

Related MCP server: mcp-server-salesforce

功能

金额以卢布为单位返回，时间为莫斯科时间。

故障排查

“密钥无效” — 密钥已被吊销、已过期，或复制时丢失了字符。请在管理后台检查，必要时重新签发。

“权限不足” — 密钥所属员工没有该板块的访问权限。请让代理执行 whoami：它会显示哪些板块已开放。

“密钥仅为只读” — 这是正常的：默认密钥不会更改任何内容。

“管理后台未响应” — 请检查 YOUREPT_API_URL。需要填写 API 实际使用的地址（通常以 api- 开头），而不是管理后台网站本身的地址。

服务器没有出现在列表中 — 几乎总是因为配置中括号未闭合或多了逗号。管理后台的密钥签发页面有现成的代码片段，可整段复制。

安全

• 数据库中只存储密钥的哈希——无法从中恢复密钥。

• 密钥继承所属员工的权限，不能超越这些权限。

• 不能用密钥来管理密钥：无法通过 API 为自己签发新的访问权限。

• 吊销即时生效。

• 界面中没有的个人数据（试听课的转录内容）无法通过此服务器访问。

员工离职时，请连同其账号一起吊销其密钥。

开发

pnpm install
pnpm build     # tsc → dist/

在不连接客户端的情况下检查服务器：

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | YOUREPT_API_URL=http://localhost:4001 YOUREPT_API_KEY=ключ node dist/index.js

诊断信息输出到 stderr——stdout 只用于协议，不能写入其他内容。