Cursorをスタジオに接続する

概要

Cursorは、AIを搭載したエディターです。AIコネクタを使うと、Cursorのチャットで質問したときに、キーに設定されたユーザー権限でスタジオのデータ（売上、顧客、予約、会計）を参照できます。データの参照のみを行い、システムの内容は変更しません。

使う場面

連携機能やウェブサイトを開発していて、エディターを離れずにスタジオの実データを確認したいとき。
日常的にCursorのチャットを使っていて、スタジオの利用状況について質問したいとき。

始める前に

AIコネクタの記事を参考に、コネクタのアドレスと、「AIコネクタとしての使用を許可」が有効なAPIキーを用意してください。

手順

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

~/.cursor/mcp.jsonファイルを開くか、新しく作成します。以下の内容を追加し、アドレスをアドレスをコピーでコピーしたものに、hk_...を自分のキーに置き換えてください。

{
  "mcpServers": {
    "heya": {
      "url": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

手順2 — 接続を確認する

Cursorの設定でMCPセクションを開きます。コネクタheyaが有効になり、listar_areas、buscar_ferramentas、executar_consultaのツールが表示されていることを確認してください。

手順3 — 質問する

Cursorのチャットで、たとえば「今日、スタジオで対応した顧客は誰ですか？」と質問します。

その後の流れ

Cursorが質問に合ったクエリを探して実行し、システムの数値を回答します。
キーのAPI Keyタブに表示される最終使用が更新されます。
アクセスを停止するには、API Keyタブでキーを失効させてください。Cursorは最長30秒でアクセスできなくなります。

よくある間違いと質問

Q: Cursorの設定でコネクタにエラーが表示されます。どうすればよいですか？ A: アドレスの末尾が/mcpになっていることと、キーがBearer とその後のスペースを含めてすべて正しく貼り付けられていることを確認してください。 mcp.jsonを編集した後、Cursorの設定でコネクタを一度オフにしてから、再度オンにしてください。

Q: キーの代わりに環境変数を使えますか？ A: Cursorのバージョンによっては、環境変数がヘッダー内で値に置き換わらず、文字列のまま送信されることがあります。環境変数を使って接続できない場合は、ユーザー用のファイルにキーを直接記入してください。

Q: プロジェクトの.cursor/mcp.jsonに設定を追加できますか？ A: おすすめしません。このファイルはバージョン管理に含まれることが多く、キーが公開されるおそれがあります。ユーザー用のファイル（~/.cursor/mcp.json）を使ってください。

Q: Cursorに、キーで「AIコネクタとしての使用を許可」が必要だと表示されます。なぜですか？ A: キーの作成時にこのオプションが有効になっていません。API Keyタブでキーを編集し、AIコネクタとしての使用を許可を選択してください。

Q: Cursorでキーを使う代わりにログイン画面が表示されます。どうすればよいですか？ A: キーを含むheadersブロックがmcp.jsonにあることを確認してください。正しいキーが設定されていれば、システムから直接応答が返るため、ログインは不要です。Cursorでログインが繰り返し求められ、ログインできない場合は、キーをClaude CodeまたはGemini CLIで使うか、サポートにお問い合わせください。

Q: コネクタを通じて、Cursorからシステムのデータを変更できますか？ A: いいえ。コネクタはデータの参照のみを行います。データを変更する場合は、システム上で操作してください。