MCP 連携

Intercom 連携設定ガイド

KocoroにプリインストールされたIntercom MCP Serverを使えば、AIがIntercomの会話・顧客・チケット・チーム情報を直接読み取れます。必要なのはスイッチを1つオンにし、OAuth認証を1回行うだけです。

はじめる前に

  • Kocoro Mac アプリがインストール済みであること(Intercom MCP Server はプリインストール済みのため、手動で Add Server する必要はありません)。
  • アクセスできる Intercom ワークスペースと、サードパーティ OAuth アプリを認可できる権限を持っていること。
  • Intercom に接続できるネットワーク環境であること。
  1. 1

    MCP Servers を開く

    Kocoro Mac アプリを起動し、左サイドバーの Capabilities グループにある MCP Servers をクリックします。ここが Intercom を含むあらゆる外部接続を管理する画面です。

    図 1:Kocoro メイン画面 — 左側の MCP Servers エントリ。
  2. 2

    プリインストール済みの Intercom を見つけてスイッチをオンにする

    Kocoro にはすでに Intercom MCP Server(https://mcp.intercom.com/mcp)がプリインストール済みです。自分で Add Server する必要はありません。intercom 行の右側のスイッチをクリックすると、Kocoro が既定のブラウザを開き、Intercom の OAuth 認可画面に遷移します。

    一覧に intercom が表示されない場合は、Kocoro を最新バージョンにアップデートしてください。
    図 2:MCP Servers 一覧 — intercom の右側のスイッチをクリック。
  3. 3

    Intercom 側で権限を確認して認可する

    Intercom の認可画面では intercom-api-mcp-server が要求するスコープを確認できます:People、Companies、Conversations、Teams and teammates、Tags、AI content などすべて読み取り専用です。問題なければ緑の Authorize access ボタンをクリックします。

    すべてのスコープは読み取り専用です。Kocoro が Intercom ワークスペースに書き込みを行うことはありません。
    図 3:Intercom OAuth 認可画面 — Authorize access をクリック。
  4. 4

    認可完了

    ブラウザが自動的に遷移し、認証成功を知らせるページ(Authorization successful! の文字)が表示されます。そのままタブを閉じれば完了です。

    図 4:OAuth コールバック成功画面。
  5. 5

    Kocoro に戻って接続を確認

    Kocoro の MCP Servers 画面に戻ると、intercom の左側に緑の丸が表示され、スイッチもオンになっています。これで Intercom MCP の接続が確立され、Kocoro から Intercom のツールを呼び出せる状態になりました。

    図 5:接続有効化 — intercom の左に緑の丸が表示される。

完了!Intercom を使ってみよう

Messages に戻り、自然な日本語(あるいは英語)で質問するだけで、Kocoro が適切な Intercom ツールを選び、構造化された結果を返します。

図 6:Messages から Intercom に質問し、構造化されたチケット一覧を取得。

おすすめのプロンプト

  • 今日 Intercom で優先対応すべき緊急チケットは?
  • 過去 7 日間の Intercom の新規会話を、顧客企業ごとに集計してください。
  • 顧客 X が今週寄せた問い合わせをまとめ、主要な要望と未解決の項目を整理してください。
  • 今日の Intercom の未読会話をすべて To-Do リストに整理してください。

トラブルシューティング

MCP Servers の一覧に Intercom が表示されません。

Kocoro を最新バージョンにアップデートしてください。Intercom MCP Server は Kocoro に同梱されており、古いバージョンには含まれていない場合があります。

スイッチをオンにしてもブラウザが自動で開きません。

システムの既定ブラウザが正しく設定されているか確認したうえで、スイッチを一度オフにしてから再度オンにしてみてください。

認可後も緑の丸が表示されません。

MCP Servers 一覧でスイッチをオフにして再度オンにします。それでも改善しない場合は Kocoro の Settings からログを確認してください。

Kocoro の Intercom へのアクセス権を取り消すには?

Intercom の Authorized apps から intercom-api-mcp-server を revoke するか、Kocoro の MCP Servers 一覧でスイッチをオフにしてください。