MCP 接続（AIクライアント連携）

Claude をはじめとする MCP クライアントを Stockwork につなぐと、AI との会話の中から Stockwork の CRM データを直接扱えます。取引の状況を尋ねる、条件に合う会社を探す、商談ログを読ませて要約させる、といった操作を、画面を開かずに依頼できます。 MCP（Model Context Protocol）は、AI クライアントが外部サービスのデータを読み書きするための共通の規格です。Stockwork は MCP サーバーとして動作するため、この規格に対応したクライアントであれば同じ手順で接続できます。

​

始める前に

• 接続は 利用者ごと に行います。管理者が代表して接続する必要はなく、また管理者の承認も要りません。
• 接続に APIキーや Client ID・Client Secret の入力は不要 です。ブラウザで Stockwork にログインして「許可」を選ぶだけで完了します。
• 見えるデータは 接続した本人の権限の範囲 に限られます。権限を超えたデータが AI クライアントから見えることはありません。
• 接続時にブラウザが開くため、ブラウザから Stockwork にログインできる環境が必要です。
• MCP 接続は順次提供中の機能です。設定 > 組織設定 に Stockwork MCP が表示されない場合、ご利用の組織にはまだ提供されていません。

​

接続URLを確認する

すべてのクライアントで共通して、Stockwork の 接続URL を使います。

1. Stockwork の 設定 > 組織設定 > Stockwork MCP を開き、接続方法 タブを選びます。
2. 接続URL の右にあるコピーボタンで URL をコピーします。

接続方法 タブには、クライアントごとの手順とコピーできるコマンドも表示されます。以下はその内容を説明したものです。

​

Claude Code から接続する

1. ターミナルで次のコマンドを実行します。<接続URL> は前の手順でコピーした URL に置き換えてください。
   claude mcp add --transport http stockwork <接続URL>
   
2. Claude Code を起動し、/mcp を実行します。
3. ブラウザが開くので、Stockwork にログインします。
4. 許可を求める画面で、接続しようとしているクライアント名と許可する操作の範囲を確認し、許可 を選びます。

接続はここで完了です。以降はトークンが自動的に更新されるため、ログインし直す必要はありません。 コマンドの stockwork の部分は、お使いのパソコン上でこの接続を呼ぶための名前です。任意の名前に変更できます。

​

Claude（Web・デスクトップアプリ）から接続する

1. Claude の 設定 > コネクタ を開きます。
2. カスタムコネクタを追加 を選び、接続URLを貼り付けます。
3. 追加されたコネクタの 接続 を選びます。
4. Stockwork にログインし、許可を求める画面で内容を確認して 許可 を選びます。

​

Codex から接続する

1. ターミナルで次のコマンドを実行します。<接続URL> は前の手順でコピーした URL に置き換えてください。
   codex mcp add stockwork --url <接続URL>
   codex mcp login stockwork
   
2. ブラウザが開くので、Stockwork にログインします。
3. 許可を求める画面で内容を確認し、許可 を選びます。

Codex は登録（add）と認証（login）が別のコマンドです。add だけでは接続は完了しません。

​

ChatGPT から接続する

1. ChatGPT の 設定 > アプリとコネクタ > 詳細設定 で デベロッパーモード を有効にします。
2. 設定 > コネクタ > 作成 を開きます。
3. 名前と説明を入力し、MCP サーバー URL に接続URLを貼り付けます。認証には OAuth を選びます。
4. 作成後、ブラウザで Stockwork にログインし、許可を求める画面で 許可 を選びます。

​

Cursor から接続する

1. Cursor の 設定 > MCP から Add new global MCP server を開きます。
2. 次の内容を貼り付けて保存します。<接続URL> は前の手順でコピーした URL に置き換えてください。
   {
     "mcpServers": {
       "stockwork": {
         "type": "http",
         "url": "<接続URL>"
       }
     }
   }
   
3. Cursor に認証を求めるリンクが表示されるので開き、Stockwork にログインして 許可 を選びます。

​

AI クライアントからできること

接続すると、AI クライアントは次のレコードを扱えるようになります。 組織で追加したカスタムプロパティも扱えます。AI クライアント側から「どのプロパティがあるか」を問い合わせられるようになっているため、事前に項目名を教える必要はありません。 レコードを削除する手段は用意していません。 AI クライアントに削除を依頼しても実行されません。削除は Stockwork の画面から行ってください。

​

権限とデータの見え方

接続には 2 つの制限がかかり、厳しいほうが適用 されます。

• 接続した本人の、その組織での権限
• 接続時に許可した操作の範囲（参照のみ／作成・更新まで）

たとえば作成・更新できる権限を持つ人が、許可の画面で参照のみを選んだ場合、その接続は参照しかできません。逆に、参照のみの権限しか持たない人が作成・更新を許可しても、作成・更新はできません。許可の操作によって、本来の権限より広い範囲が見えるようになることはありません。 接続後に組織での権限が変更された場合も、変更後の権限が適用されます。接続し直す必要はありません。

​

接続を解除する

設定 > 組織設定 > Stockwork MCP の 管理 タブに、接続中のクライアントの一覧が表示されます。一般のメンバーには自分の接続が、管理者には組織内のすべての接続が表示されます。 解除したい行の 解除 を選び、確認画面で 解除する を選びます。解除するとそのクライアントからのアクセスは直ちに停止します。 一覧の 最終利用日時 は、そのクライアントが最後に Stockwork のデータへアクセスした時刻です。未利用 と表示されている接続は、許可されたあと一度も使われていません。

​

うまくいかないとき

接続URLを入力しても認証画面が出ない 普段開いている Stockwork の画面の URL を使っていないか確認してください。接続URLは別のドメインです。設定 > 組織設定 > Stockwork MCP > 接続方法 からコピーし直してください。 許可の画面で組織が選べない、または想定と違う組織が表示される 許可の対象になるのは、Stockwork にログインしている組織です。複数の組織に所属している場合は、先に Stockwork の画面で目的の組織に切り替えてから、接続をやり直してください。 接続はできたが、AI クライアントが「その操作はできない」と答える 参照のみで許可した接続では、作成・更新の操作は AI クライアントからは見えません。作成・更新も行いたい場合は、一度接続を解除し、許可の画面で作成・更新を含めて接続し直してください。 接続が切れた、または応答しなくなった 管理者が 設定 > 組織設定 > Stockwork MCP > 管理 から接続を解除した可能性があります。一覧に自分の接続が残っていない場合は、改めて接続してください。