AIツールをEspobaseに接続する
Espobaseコネクタを使うと、Claude、ChatGPT、Cursor、VS Code、その他Model Context Protocol（MCP）対応ツールでプロジェクトを操作できます。スキーマとAPIリファレンスの読み取り、型の生成、読み取り専用クエリの実行、ログと使用量の確認、そしてあなたが承認するデータベース変更の提案が可能です。
接続
Claude（claude.ai、Claude Desktop）とChatGPT： 下のサーバーURLでカスタムコネクタを追加し、「接続」をクリックします。Espobaseにログインし（メール、GitHub、Google、AppleまたはSSO）、ツールに許可する内容を確認して「許可」をクリックします。コピーするキーはありません。
https://app.espobase.com/api/mcp
Claudeの場合：Settings › Connectors › Add custom connector。ChatGPTの場合：Settings › Connectors（またはApps）。
Claude Code、Cursor、VS Code、その他のMCPクライアント： ダッシュボード（アカウント設定 › 開発者）でパーソナルアクセストークンを作成します。そこには各ツール向けの貼り付けるだけの設定も用意されています。たとえばClaude Codeでは：
claude mcp add --transport http espobase https://app.espobase.com/api/mcp \ --header "Authorization: Bearer <your token>"
Espobaseのアカウントが必要です。コネクタはすべてのプランで使えます。
接続したツールでできること・できないこと
- あなたとして動作します。あなたがアクセスできる組織とプロジェクトだけを、あなたのロールで扱います。
- 同意画面で許可したもの（例：スキーマ、ログ、読み取り専用SQL）だけが見えます。
- SQLは常に読み取り専用です。データや構造を変更するステートメントは、あなたがプロジェクトのオーナーであっても拒否されます。
- データベースの変更を提案することはできますが、適用することはできません。SQLをレビューし、プロジェクトのAIタブで「適用」をクリックするのはあなたです。
- データベースのパスワード、APIのシークレットキー、その他の認証情報を受け取ることはありません。
- アカウント設定 › 開発者 › 接続済みのアプリでいつでも接続を解除でき、アクセスはすぐに終了します。
ツール
| whoami | あなたのEspobaseアカウントと組織。 |
| list_projects | アクセスできるプロジェクトと、そのステータス、環境、リージョン、あなたのロール。 |
| get_project | 1つのプロジェクトの詳細。 |
| get_schema | テーブル、カラム、リレーション、行レベルセキュリティ、ポリシー（構造のみ）。 |
| get_api_reference | クライアントコードを書くためのRESTエンドポイント、フィルター、認証、SDKの使い方。 |
| generate_typescript_types | @espobase/clientで型付きクエリを書くためのespobase.types.ts。 |
| run_read_only_sql | プロジェクトの読み取り専用データベースログインで実行するSELECTクエリ。 |
| get_logs | 最近のリクエストログ（パス、ステータス、所要時間。本文やシークレットは含みません）。 |
| get_usage | APIリクエスト、帯域幅、データベースとファイルのストレージ、AIの使用量。 |
| list_storage | バケット、フォルダ、ファイル名（ファイルの内容は含みません）。 |
| propose_schema_change | あなたがレビューして適用するためのプラン（テーブル、リレーション、ポリシー…）とそのSQL。 |
| create_project | 新しいプロジェクト（プロジェクトの作成を許可した場合）。 |
質問の例
- “Espobaseのプロジェクトを一覧表示し、メインプロジェクトのデータベーススキーマを要約してください。”
- “プロジェクト内で、行レベルセキュリティは有効だがまだポリシーがないテーブルはどれですか？”
- “@espobase/clientを使って、Espobaseプロジェクトから最新の注文20件を一覧表示するNext.jsのページを書いてください。”
- “今週、プロジェクトが処理したAPIリクエストは何件で、ログにエラーはありましたか？”
- “ログイン中の各ユーザーが自分のToDoだけを見られるtodosテーブルを提案してください。”
あなたのデータ
AIツールに何かを尋ねると、コネクタはそのツールに回答を返します。たとえば、テーブル名やカラム名、クエリ結果、ログのエントリ、ファイル名などです。その内容は、AIプロバイダーが自社の規約とプライバシーポリシーに基づいて扱います。EspobaseがAIツールとの会話を受け取ることはありません。受け取るのは各ツール呼び出しで送信される内容だけです。たとえば実行するSQLクエリや、propose_schema_changeの場合は変更リクエストで、後者はダッシュボードで入力されたリクエストと同様にプロジェクトのAI履歴に保存されます。ツール呼び出しは、セキュリティと監査のために記録されます（どのエンドポイントか、いつか、結果のステータス）。
情報の取り扱いについてはEspobaseのプライバシーポリシーをご覧ください。
トラブルシューティング
- ツールがスコープ不足を報告する場合： 接続を解除してから再接続してください（またはそのスコープを持つトークンを作成してください）。
- 組織がシングルサインオン（SSO）を必須にしている場合： 接続する前にSSOでEspobaseにログインしてください。
- プロジェクトが一覧に表示されない場合： 一部のプロジェクトにしかアクセス権がない可能性があります。組織の管理者に問い合わせてください。
お困りですか？サポートに問い合わせる。