yourept-mcp

CRM YOUREPT 用の MCP サーバー。Claude、Cursor、Codex などの MCP クライアントに接続し、エージェントに管理画面のデータ（申し込み、生徒、講師、レッスン、支払い、講師への支払い、財務レポート）へのアクセスを提供します。

このサーバーが存在する理由となる質問:

「今月の売上はいくらで、講師への支払いはいくらだった？」 「期限切れの申し込みはどれで、どのマネージャーのもの？」 「2週間レッスンがない生徒を表示して」 「Rocket Work で契約に署名していない講師は誰？」

つまり、インターフェースで3つのセクションを開いて手作業で数字をまとめなければならないようなことを実現します。

インストール

1. キーを取得する

管理画面で: 設定 → APIキー → キーを作成。キーは一度だけ表示されるので、すぐにコピーしてください。紛失した場合は新しいものを発行し、古いものは失効させてください。

キーは発行した従業員の名前と権限で動作します。その人物に閉じられたセクションはエージェントにも閉じられています。「読み取り専用」(デフォルト) のキーは、CRM 内の何も物理的に変更できません。

2. サーバーを自分のプログラムに設定する

別途インストールする必要はありません — npx がパッケージを自動でダウンロードします。

パッケージは GitHub から直接インストールされます。npm に公開された後は、github:Skamatoz/yourept-mcp の代わりに単に 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 にはプロトコルのみで、そこに書き込むことはできません。