Claude Codeをスタジオに接続する

概要

Claude Codeは、パソコンのターミナルで動作するAnthropicのClaudeです。AIコネクタを使うと、質問に応じてスタジオのデータ（売上、顧客、予約、財務情報）を確認できます。確認できるデータは、キーを使用するユーザーの権限に基づきます。データの参照のみで、システムの情報を変更することはありません。

使う場面

パソコンでClaude Codeを使っていて、Claude Codeから離れずにスタジオの状況について質問したいとき。
システムの数値を使った概要や表を、普段の言葉で指示して作成したいとき。

始める前に

AIを接続するの記事に沿ってコピーしたコネクタのアドレスを用意してください。パソコンにClaude Codeがインストールされている必要があります。接続にはシステムへのログインを使います。ログインを使わない場合（ブラウザーのないパソコンなど）は、APIキーも使用できます。

手順

手順1 — コネクタを追加する

ターミナルで以下のコマンドを実行し、アドレスをアドレスをコピーでコピーしたものに置き換えます。

claude mcp add --transport http heya https://seu-dominio/mcp

Claude Codeで/mcpと入力し、heyaを選んで認証します。ブラウザーでシステムのログイン画面が開きます。ログインして会社を選択し、認可をクリックします。

APIキーを使う場合（AIコネクタとしての使用を許可を有効にして作成したキー）、コマンドに次のヘッダーを追加します：--header "Authorization: Bearer hk_..."。

現在のフォルダーだけでなく、パソコン内のすべてのフォルダーでコネクタを使うには、コマンドに --scope userを追加します。

手順2 — 接続を確認する

claude mcp listを実行します。コネクタheyaが接続済みとして表示されます。Claude Code内では、/mcpコマンドでも同じ情報を確認できます。

手順3 — 質問する

Claude Codeを開き、たとえば「昨日、スタジオでいくら売り上げましたか？」と質問します。初回は、コネクタのツールを使う許可を求められる場合があります。

その後の流れ

質問に合った情報を取得し、該当する処理を実行して、システムの数値を回答します。
キーのAPI Keyタブに、更新された最終使用が表示されます。
アクセスを停止するには、API Keyタブでキーを失効させます。Claude Codeからのアクセスは30秒以内に停止します。

よくある間違いと質問

Q: claude mcp listに「Failed to connect」と表示されます。どうすればよいですか？ A: アドレスが/mcpで終わっていることと、キー全体をBearer およびその後のスペースも含めて貼り付けたことを確認してください。このコマンドはキーをテストせずに設定を保存するため、Claudeが接続を試みたときに初めてエラーが表示されます。

Q: Claudeから、キーに「AIコネクタとしての使用を許可」が必要だと言われました。なぜですか？ A: このオプションを有効にせずにキーを作成しています。API Keyタブでキーを編集し、 AIコネクタとしての使用を許可を有効にしてください。

Q: キーを変更するにはどうすればよいですか？ A: claude mcp remove heyaでコネクタを削除し、新しいキーを使って追加し直します。

Q: リポジトリを使ってチームと設定を共有できますか？ A: 共有ファイルにキーを記載しないでください（--scope projectを使うと.mcp.jsonに保存されます）。各自が自分のユーザー権限に基づくキーを使用してください。

Q: システムでは確認できる情報が見つからないとClaudeに言われました。なぜですか？ A: キーのユーザーにその画面を見る権限がないか、セキュリティ上の理由でコネクタの対象外の情報である可能性があります（WhatsAppの会話、問診情報、写真、デジタル口座）。AIコネクタの記事をご覧ください。