概要
AI に amoCRM で作業させます。パイプラインをまたいだ商談の検索と更新、コンタクトと会社の検索、タスク・メモ・イベントログの確認、新しいタスクとメモの記録ができます。amocrm.ru のアカウント向けで、アカウント内の連携で発行する長期トークンを使います。
ガイド付きセットアップ
amoCRM を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで amoCRM を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
amoCRM のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → amoCRM をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
amoCRM + Microsoft Copilot
AI に amoCRM で作業させます。パイプラインをまたいだ商談の検索と更新、コンタクトと会社の検索、タスク・メモ・イベントログの確認、新しいタスクとメモの記録ができます。amocrm.ru のアカウント向けで、アカウント内の連携で発行する長期トークンを使います。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
AMOCRM_SUBDOMAIN, AMOCRM_ACCESS_TOKEN
ステップ 1 — 認証情報を取得
- amoCRM の左メニューで амоМаркет（amoMarket）を開き、右上の ⋯（+ WEB HOOKS の横）をクリックして Создать интеграцию（連携を作成）を選び、続けて Внешняя интеграция（外部連携）を選びます。アカウント管理者である必要があります。
- Ссылка для перенаправления（リダイレクト URL）を入力します。フォームでは必須ですが、長期トークンでは使われないため、自分の https アドレスであれば何でもかまいません。Предоставить доступ でアクセス権にチェックを入れ、連携の名前と説明を入力して Сохранить（保存）をクリックします。
- 連携の Ключи и доступы（キーとアクセス）タブを開き、Сгенерировать токен（トークンを生成）をクリックします。有効期限を 1 日から 5 年の間で選び、すぐにトークンをコピーしてください。amoCRM がトークンを表示するのは一度だけです。
- トークンを
AMOCRM_ACCESS_TOKENに、アカウントのサブドメインをAMOCRM_SUBDOMAINに貼り付けます。https://acme.amocrm.ruならacmeと入力します。その後、コネクターをインストールします。 - まず
amocrm_get_accountを実行します。アカウント、その通貨、タスクの種類を確認できます。
amoCRM と Kommo: どちらも同じ製品です。<subdomain>.amocrm.ru のアカウントはこのコネクターを使います。旧国際版のアドレス <subdomain>.amocrm.com はそちらに転送されるため、同じサブドメインを入力してください。<subdomain>.kommo.com のアカウントは Kommo コネクター を使います。
誰のトークンか: トークンは、それを作成した管理者として動作します。取り消すには、連携の Выданные доступы タブで Отозвать доступ をクリックします。期限が切れたら、新しいトークンを発行して貼り付けてください。
まず確認: 商談の作成や変更、コンタクトやタスクの作成、メモの追加を行う前に、AI は書き込む内容を示してあなたの承認を待ちます。amoCRM は新しいコンタクトの重複をチェックしないため、AI は先に検索します。
読み取り専用の設定: amoCRM のトークンは読み取り専用に制限できないため、amocrm_create_lead、amocrm_update_lead、amocrm_create_contact、amocrm_create_task、amocrm_add_note をオフにします。このコネクターには、データを削除する機能はありません。
パイプライン、ステージ、フィールド: API では商談はリード（lead）と呼ばれます。すべての商談はいずれかのパイプラインのステージに属しており、amocrm_list_pipelines でそれらを一覧できます。どのパイプラインでも、ステージ 142 は Closed-won（Успешно реализовано、成約）、143 は Closed-lost（Закрыто и не реализовано、失注）です。電話番号、メールアドレス、その他の追加データはカスタムフィールドで、amocrm_list_custom_fields が ID と選択肢とともに一覧表示します。担当ユーザーは amocrm_list_users で取得します。
メモとイベントログ: amocrm_list_notes は 1 件の商談、コンタクト、会社のタイムラインを読みます。amocrm_list_notes_by_type はすべてのレコードのメモをまとめて読み、たとえば今週記録された通話をすべて取得できます。amocrm_list_events はアカウントのイベントログを読みます。ステージの変更、新しいレコード、フィールドや担当者の変更、通話、チャットメッセージ、完了したタスクを、変更前と変更後の値とともに確認できます。
制限: 1 秒あたりのリクエストは連携ごとに最大 7 件、アカウントごとに最大 50 件です。これを超えると amoCRM は 429 を返し、違反を繰り返すとアカウントの API アクセスがブロックされて、すべての呼び出しに 403 が返ります。すべての商談やイベントをページ送りで読ませるのではなく、絞り込みや検索をするよう AI に指示してください。
よくあるエラー: 401 は、トークンが間違っている、期限切れ、取り消し済みのいずれか、または amocrm.ru にそのサブドメインのアカウントがないことを示します（kommo.com のアカウントには Kommo コネクターが必要です）。402 はサブスクリプションが終了したことを示します。書き込みはすぐに、読み取りは 30 日後に停止します。403 は、トークンのユーザーに権限がないこと、またはリクエストが多すぎて API アクセスがブロックされたことを示す場合があります。404 は、ID またはサブドメインが間違っていることを示します。400 では無効なフィールドが一覧表示されます。たとえば、そのパイプラインに属さないステージや、型が合わないカスタムフィールドの値などです。
このコネクターは何も削除せず、顧客（покупатели）、受信（未振り分け）リード、チャットとメッセージ、リスト（カタログ）、Webhook、Salesbot は扱いません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
amoCRMのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
amocrm_get_account | Get the amoCRM account: id, name, subdomain, current user id, country, currency, language, and with the default extras its task types (ids… |
amocrm_list_leads | List or search deals (leads in the API): id, name, price, pipeline and stage (status_id), responsible user, dates, tags, custom fields and… |
amocrm_get_lead | Get one lead by id with its name, price, pipeline, stage, responsible user, dates, tags, custom field values, linked company and, by… |
amocrm_create_lead | Create a lead, optionally in a given pipeline and stage, with price, responsible user, custom fields, tags and links to existing contacts… |
amocrm_update_lead | Change a lead: name, price, stage or pipeline (moving it through the funnel; Closed-won is status 142, Closed-lost 143), responsible user… |
amocrm_list_contacts | List or search contacts: id, name, first and last name, responsible user, dates, tags, custom fields (phone and email are custom fields)… |
amocrm_get_contact | Get one contact by id with names, responsible user, tags, custom field values (phones, emails, position), linked companies and, by default… |
amocrm_create_contact | Create a contact with name, responsible user, phone, email and other custom fields, and tags |
amocrm_list_companies | List or search companies: id, name, responsible user, dates, tags, custom fields and, with with=leads,contacts, linked leads and contacts |
amocrm_list_pipelines | List the lead pipelines with their stages: pipeline id, name, whether main or archived, and per stage (in _embedded.statuses) its id, name… |
amocrm_list_custom_fields | List the custom fields of leads, contacts or companies: id, name, code (PHONE, EMAIL for contacts), type and, for select fields, the enum… |
amocrm_list_tasks | List tasks: id, text, type, deadline (complete_till), whether completed, result, responsible user and the lead, contact or company it… |
amocrm_create_task | Create a task with a deadline, linked to a lead, contact or company, for a responsible user |
amocrm_list_notes | Read the notes (timeline entries) of one lead, contact or company: id, type (common text note, call_in, call_out, sms, service messages… |
amocrm_list_notes_by_type | Read notes across all leads, contacts or companies at once, not just one record: id, entity_id of the record it belongs to, type (common… |
amocrm_add_note | Add a text note to the timeline of a lead, contact or company |
amocrm_list_users | List the account's users: id, name, email, language and rights, and with with=role,group their role and group |
amocrm_list_events | Read the account's event log: who did what and when |
amocrm_list_loss_reasons | List the account's loss reasons (причины отказа) for deals: id, name and sort order |
プロンプトの例
- 「Sales パイプラインで Negotiation ステージにある商談と、それぞれの担当者を教えてください。」
- 「今週、商談を Closed-lost にしたのは誰ですか？その商談の金額も教えてください。」
- 「月曜日以降に記録された着信通話と、それぞれが紐づく商談をすべて見せてください。」
- 「商談『Stroymarket 向け倉庫ラック』を Closed-won に移動し、担当マネージャーに月曜日のフォローアップタスクを作成してください。」
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?