mcp-crm

学習用プロジェクトです。Model Context Protocol サーバーで、CRM を stdio 経由で MCP クライアントに公開します。

サインインはデバイスコードフローを利用して Microsoft Entra で行われます。取得した ID トークンは CRM アクセストークンに交換され、CRM クエリはサインインしたユーザーとして実行されます。そのため、返されるのは、そのユーザーが閲覧を許可されたデータだけです。

要件

• Node.js 20+

• デバイスコード（パブリッククライアント）フローを有効にした Entra アプリの登録

• POST /api/auth/entra で Entra トークンを受け付け、GET /api/accounts を提供する CRM API

Related MCP server: Relay MCP

セットアップ

npm install

プロジェクトルートに .env を作成してください:

ENTRA_CLIENT_ID=<your app registration's client id>
ENTRA_TENANT_ID=<your directory tenant id>
CRM_API_BASE_URL=https://your-crm.example.com

3 つすべて必須です。いずれかが欠けていると、サーバーは起動時に例外をスローします。.env は gitignore されているため、コミットしないでください。

実行

npx tsx src/index.ts     # run directly
npx tsc                  # type-check and build to dist/

サーバーは stdio 上で MCP を利用して通信するため、通常は手動ではなくクライアントから起動されます。Claude Code に登録するには:

{
  "mcpServers": {
    "crm": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/mcp-crm/src/index.ts"]
    }
  }
}

ログ出力は stderr に送られます。stdout が MCP プロトコルを運ぶためです。

ツール

サインインの流れ

start_crm_login は Entra が完了するまでブロックできないため、次の 2 つに分かれています:

1. start_crm_login を呼び出します。デバイスコードとアクセス先の URL が返されます。

2. ブラウザーでサインインを完了します。

3. 確認のために crm_login_status を呼び出します。サインインしたユーザーが報告されたら、search_crm_accounts が動作します。

トークンはメモリ内のみに保持されます。サーバーを再起動すると、再びサインインする必要があります。

ライセンス

ISC