@theyahia/amocrm-mcp

本番運用グレードのMCPサーバーです。amoCRM API用に、リード、連絡先、企業、パイプライン、タスク、メモ、検索、イベント、未選別リードをカバーする19のツールを提供します。OAuth 2.0による自動トークン更新、レート制限（7 req/sec）、指数バックオフ再試行を備えています。

インストール

npx -y @theyahia/amocrm-mcp

Related MCP server: amocrm-mcp

MCP 設定

Claude Desktop、Cursor、または任意のMCPクライアント設定に追加してください:

{
  "mcpServers": {
    "amocrm": {
      "command": "npx",
      "args": ["-y", "@theyahia/amocrm-mcp"],
      "env": {
        "AMOCRM_SUBDOMAIN": "mycompany",
        "AMOCRM_ACCESS_TOKEN": "your-access-token",
        "AMOCRM_REFRESH_TOKEN": "your-refresh-token",
        "AMOCRM_CLIENT_ID": "your-client-id",
        "AMOCRM_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

環境変数

AMOCRM_DOMAIN は AMOCRM_SUBDOMAIN のエイリアスとしても受け付けられます（後方互換性）。

ツール (19)

リード

連絡先

企業

パイプライン

タスク

未選別

メモ

検索

イベント

アカウント

デモプロンプト

営業概要:

「Sales」パイプライン内で現在「Negotiation」ステージにあるすべてのリードを表示してください。連絡先情報も含めてください。

タスク管理:

リード #12345 にフォローアップ通話タスクを作成してください。期限は明日の午前10:00です。その後、私の未完了タスクをすべて一覧表示してください。

新規クライアントのオンボーディング:

「Ivan Petrov」という連絡先を電話番号 +79001234567 で作成し、次に「Petrov Solutions」という企業と、メインパイプラインに 150,000 RUB の「Website Development」というリードを作成してください。

OAuth 2.0 設定ガイド

1. amoCRMのアカウント設定に移動: https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/

2. 新しいインテグレーション（外部インテグレーション）を作成

3. リダイレクトURIを https://YOUR_SUBDOMAIN.amocrm.ru に設定

4. Client ID と Client Secret をコピー

5. インテグレーションを認証して初期のAuthorization Codeを取得

6. コードをトークンと交換:

curl -X POST https://YOUR_SUBDOMAIN.amocrm.ru/oauth2/access_token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "grant_type": "authorization_code",
    "code": "YOUR_AUTH_CODE",
    "redirect_uri": "https://YOUR_SUBDOMAIN.amocrm.ru"
  }'

7. レスポンスから access_token と refresh_token を保存

8. AMOCRM_REFRESH_TOKEN、AMOCRM_CLIENT_ID、AMOCRM_CLIENT_SECRET が設定されている場合、サーバーは期限切れのトークンを自動的に更新します。

エラーハンドリング

• 401 Unauthorized: リフレッシュ資格情報が設定されている場合はトークンを自動更新して再試行

• 429 Rate Limited: Retry-After ヘッダーを尊重し、待機して再試行

• 5xx Server Errors: 指数バックオフで再試行（最大3回）

• Rate Limiting: amoCRMの制限内に収めるため、リクエスト間に150msの遅延を内蔵（約7 req/sec）

開発

git clone https://github.com/theYahia/amocrm-mcp.git
cd amocrm-mcp
npm install
npm run build
npm test

ライセンス

MIT