item MCP Server

item MCP Server とは？

item MCP Server は、AI クライアントを item のワークスペースにつなぐ公式のホスト型エンドポイントです。Claude、ChatGPT、Cursor、Codex から CRM レコードを検索し、item アシスタントに質問し、ノート、タスク、リストを更新できます。

item は、ビジネスを理解し、顧客を把握し、仕事をこなす AI ネイティブなシステムで、CRM を置き換えるために設計されていると説明しています。テーブル、カンバン、カスタムオブジェクト、データエンリッチメント、リード発見、そして文章で書いたプロセスから作る AI エージェントを提供します。item MCP サーバーはこのワークスペースを https://mcp.item.app/mcp で Model Context Protocol クライアントに公開し、OAuth により各ユーザーが自分の item アカウントでサインインします。

item MCP Server の使い方

有効なアプリアクセス権を持つ item アカウントが必要です。item のドキュメントによると、MCP のアクセスはウェブアプリと同じ課金ルールに従います。item は現在、ウェブサイトのウェイトリストを通じて新規顧客を受け入れています。

サーバー URL は次のとおりです。

https://mcp.item.app/mcp

クライアントがトランスポートを尋ねた場合は HTTP、Streamable HTTP、Remote HTTP のいずれかを選びます。サインインはブラウザで行います。クライアントが item の認可ページを開くので、使いたいアカウントでサインインし、要求されたアクセス内容を確認して許可します。

Claude Code

claude mcp add --transport http item https://mcp.item.app/mcp

Claude Code を起動して /mcp を実行し、item を選んでブラウザで OAuth フローを完了します。すべてのプロジェクトで使うには --scope user を付けます。

claude mcp add --transport http --scope user item https://mcp.item.app/mcp

Claude Desktop と claude.ai

Pro または Max プランでは、Customize > Connectors を開いて + をクリックし、Add custom connector を選びます。名前に item、URL に https://mcp.item.app/mcp を入力します。管理者から指定がない限り、詳細な OAuth クライアント項目は空欄のままにして Connect をクリックします。Team と Enterprise プランでは、組織の Owner が先に Organization settings > Connectors でコネクタを追加する必要がある場合があります。

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に以下を追加し、Cursor を再起動して MCP 設定から接続します。

{
  "mcpServers": {
    "item": {
      "url": "https://mcp.item.app/mcp"
    }
  }
}

VS Code

.vscode/mcp.json に追加します。サーバー起動時に VS Code がサインインを促します。

{
  "servers": {
    "item": {
      "type": "http",
      "url": "https://mcp.item.app/mcp"
    }
  }
}

Codex

codex mcp add item --url https://mcp.item.app/mcp

item MCP Server の主な機能

• 公式かつホスト型：item 自身がサーバーをドキュメント化しており、ローカルでのインストールや実行は不要です。
• ユーザーごとの OAuth：各自が自分の item アカウントを接続します。使えるツールはそのアカウントの権限と接続済みの連携によって変わります。
• 読み取り専用のアシスタント：item のドキュメントによると、ask_item_assistant はオブジェクトの種類、メール、会議、会議の録音、タイムラインを横断した分析が必要な複雑な質問に答え、追加の質問用に thread_id を返します。
• 構造化された CRM アクセス：ドキュメントには、オブジェクトの検索と取得、オブジェクト種別の一覧、スキーマの読み取り、CRM オブジェクトの作成・更新・削除を行うツールが記載されています。
• ビューとリスト：フィルターと並び順を保持した保存済みビューを実行し、リストの閲覧、作成、編集ができます。
• ノートとタスク：ノートの作成と編集、AI またはユーザー向けタスクの検索、作成、更新、削除ができます。
• 意図的に絞った範囲：item によると、外部へのメッセージ送信、カレンダーへの書き込み、Slack や LinkedIn への送信、クレジットを消費するエンリッチメント、生の SQL、一括変更、スキルの起動は MCP ツールとして公開されていません。

item MCP Server のユースケース

• パイプラインの質問：「今週ステージが進んだ案件と、それぞれ前回の会議で話した内容を item に聞いて」。
• コーディングや執筆中のレコード参照：「item で Acme 社を探して、カスタムフィールドを表示して」。
• 通話のフォローアップ：「この連絡先で最後に記録された電話は？」、続けて「次のステップをまとめたノートを作成して」。
• タスク管理：「このリードに来週火曜フォローアップするタスクを作成して」。
• リスト作成：「'Hot leads' ビューを実行して、上位 10 社を新しいリストに追加して」。

item MCP Server のトラブルシューティング

• ブラウザで「Missing authorization」と表示される：https://mcp.item.app/mcp を直接開くとこのエラーが出ますが、想定どおりです。MCP クライアントから接続してください。
• ブラウザが開かない：クライアントが表示する認可 URL をコピーして手動で開きます。
• 別のアカウントで接続してしまった：クライアントでサーバーを削除または切断し、追加し直して正しい item アカウントでサインインします。
• サインイン前に「Unauthorized」と出る：クライアントから接続を再試行します。最初の未認証リクエストは、クライアントが item の OAuth 設定を見つけるための仕組みです。
• クライアントが stdio にしか対応していない：直接は接続できません。HTTP で item と通信できるリモート MCP ブリッジまたはプロキシが必要です。