対象
Growthプラン以上のご契約者
プロファイルで「外部AIツール連携（MCP）」が有効になっているユーザー
概要
MCP（Model Context Protocol）サーバーを利用すると、ClaudeからMazrica Salesのデータを参照・登録・更新できます。
Claude（claude.ai／Claude Desktop／Claude Codeなど）にチャットで話しかけるだけで、Mazrica Salesの画面を開かずにデータを確認したり、活動を記録したりできます。
たとえば、「株式会社〇〇の担当者を見せて」「〇〇案件のフェーズを『提案中』に更新して」「今日の△△社への訪問をアクションとして登録して」のように依頼できます。
Claudeから実行できる操作は、Mazrica Open API v2で提供している範囲です。
対応している操作はAPI v2 リファレンスをご確認ください。
ご利用までの流れ
MCPサーバーを使うには、Mazrica SalesとClaudeの両方で次の設定が必要です。
手順 | 誰によって？ | 内容 |
1 | Mazrica Salesの管理者 | プロファイルで「外部AIツール連携（MCP）」を有効にする |
2 | 各ユーザー | Claudeにカスタムコネクタを追加し、接続URLを入力する |
3 | 各ユーザー | ブラウザでMazrica Salesにログインし、許可画面で承認する |
プロファイルで利用を許可する（管理者）
MCPサーバーを利用できるかどうかは、プロファイルごとに設定します。
初期設定では、プロファイル「管理者」は有効、プロファイル「一般」は無効です。
プロファイル「管理者」のユーザーは、この設定をせずに「Claudeと接続する」へ進めます。
設定＞権限＞プロファイルを開きます
利用を許可するプロファイルを選択します
「AIアシスタント」の直下にある「外部AIツール連携（MCP）」にチェックを入れます
設定を保存します
「外部AIツール連携（MCP）」は、APIの利用権限とは別に設定します。
たとえば、APIは利用できるがMCPサーバーは利用できない、という設定もできます。
システムプロファイル「一般」は内容を変更できません。
プロファイル「一般」のユーザーに利用を許可する場合は、「外部AIツール連携（MCP）」を有効にしたカスタムプロファイルを作成し、対象のユーザーに割り当ててください。
設定を変更したときにすでにClaudeと接続していたユーザーは、Claudeのコネクタを接続し直すと変更が反映されます。
Claudeと接続する
claude.ai／Claude Desktopの場合
Claudeの設定＞コネクタを開きます
「カスタムコネクタを追加」を選択します
URLに
https://sales-mcp.mazrica.com/mcpを入力し、追加します（末尾の「/mcp」まで入力してください）ブラウザにMazrica Salesのログイン画面が表示されたら、ログインします
許可画面が表示されたら、「Authorize」をクリックして承認します
💡ClaudeをTeamプランまたはEnterpriseプランでご利用の場合、
カスタムコネクタの追加はClaudeの組織管理者へご依頼を。
Mazrica Salesへのログインと承認は、各ユーザーにて行っていただきます。
Claude Codeの場合
ターミナルで次のコマンドを実行し、MCPサーバーを登録します
claude mcp add --transport http mazrica-sales <https://sales-mcp.mazrica.com/mcp>Claude Codeで
/mcpを実行し、表示される案内に従ってMazrica Salesにログインし、承認します
権限の考え方
Claudeからの操作は、接続したユーザー本人のMazrica Sales上の権限で実行されます。
普段の画面操作でできる範囲を超えて、閲覧・編集することはできません。
閲覧・編集できるデータ
画面と同じロールの設定が適用されます。閲覧権限のないデータは、検索しても結果に表示されません。一括処理・設定変更など
画面と同じく、プロファイルで該当の権限を持つユーザーだけが実行できます。
他社のデータ
ご契約の環境以外のデータにはアクセスできません。
利用上限
Claudeからの利用は、個人APIキー（PAT）による利用と合わせて、1ユーザーごとに次の上限で数えます。
項目 | 上限（PATの利用と合算） |
1日あたり | 1ユーザー50,000リクエスト |
1秒あたり | 1ユーザー5リクエスト |
Claudeへの1回の依頼で、複数のリクエストが送られることがあります。
1日の上限は、日本時間9:00（UTC 0:00）にリセットされます。上限に達すると、リセットされるまでClaudeからの操作はエラーになります。
チームAPIキー（TAT）の上限（1ドメイン200,000リクエスト/日）とは別に数えるため、TATを使った連携には影響しません。
APIのリクエスト上限について詳しくは、Mazrica APIを利用するをご確認ください。
注意事項
現在、MCPサーバーに接続できるAIはClaudeのみです。
Claudeから登録・更新・削除した内容は、そのままMazrica Salesのデータに反映されます。
よくあるご質問
個人APIキー（PAT）の発行は必要ですか？
必要ありません。MCPサーバーは、Claudeとの接続時にMazrica Salesへログインして承認する方式で認証します。APIキーやクライアントID・クライアントシークレットを入力する必要はありません。
Claudeとの接続に失敗します
接続URLが正しく入力されているかご確認ください。
URLは末尾の「/mcp」まで含めて
https://sales-mcp.mazrica.com/mcpと入力します。「http」ではなく「https」で始まっているか、末尾に余分なスラッシュが入っていないかもご確認ください。
「権限がありません。」と表示されます
ご利用のプロファイルで「外部AIツール連携（MCP）」が無効になっています。
無効の場合も、Claude上にはMazrica Salesの操作（ツール）が表示されますが、
実行すると「権限がありません。」というエラーになります。管理者に、プロファイルの設定をご確認ください。
「外部AIツール連携（MCP）」を有効にしたのに使えません
Claudeは、接続した時点の権限で使える操作を読み込みます。
設定を変更する前から接続していた場合は、Claudeのコネクタを一度接続し直してください。
プロファイルに「外部AIツール連携（MCP）」の項目が表示されません
ご利用の環境でAPIの利用が有効になっていない（Starter環境の方も含みます）は、この項目は表示されません。
[email protected]またはオンラインチャットサポート宛てにお問い合わせください。