コンテンツへスキップ
オーラベースのロゴ
オーラベース

MCP サーバー

Claude Desktop、Cursor、Windsurf、Antigravity、Mistral AI、VS Code、または任意の Model Context Protocol 互換クライアントから Aurabase バックエンドを制御します。86 ツール、製造値なし。

リファレンス7 分 読み取りレベル 参照2026/10/18 に改訂

この翻訳以降、英語のソースが変更されました。一部の情報は古い可能性があります。
このページは自動翻訳されました。英語版が正式です。

デフォルトではローカル stdio モード、ローカル HTTP モード#

公式 Aurabase MCP サーバーは、バックエンド (プロジェクト キーを含む 82) を検査および制御するための 86 ツール を公開します。次の 2 つのモードのいずれかでマシン上で実行されます。

  1. stdio モード (デフォルト): MCP クライアントは、 npxのサブプロセスとしてサーバーを起動します。
  2. HTTP モード (ストリーミング可能な HTTP): 1 つのローカル サーバー (http://127.0.0.1:3001/mcp) を起動し、各クライアントにその URL を指定します。

ホストされたサービス (https://mcp.aurabase.dev/mcp、 OAuth 2.1 でサインイン) は計画されていますが、まだ公開されていません。

パッケージには 2 つのバイナリ (aurabase-mcp および aurabase-mcp-hosted) があるため、 npx にはバイナリ名 npx -y -p @aurabase/mcp-server aurabase-mcpが必要です。 --project-id は必須です。

terminalbash
npx -y -p @aurabase/mcp-server aurabase-mcp \
  --url https://<slug>.aurabase.cloud \
  --project-id <uuid> \
  --service-role-key aura_sk_…

代わりにローカル HTTP サーバーを起動するには、トランスポート、ポート、トークンを追加します。

terminalbash
npx -y -p @aurabase/mcp-server aurabase-mcp \
  --transport http \
  --port 3001 \
  --auth-token my_secret_token \
  --url http://localhost:8080 \
  --project-id <uuid> \
  --service-role-key aura_sk_…

クライアントごとおよびモードごとの構成#

標準出力モード (デフォルト)

カーソル (.cursor/mcp.json)、Claude Desktop (claude_desktop_config.json)、Windsurf (~/.codeium/windsurf/mcp_config.json)、Google Antigravity (~/.gemini/config/mcp_config.json)、および Cline または Roo コードを使用した VS Code (cline_mcp_settings.json) は、同じブロックを使用します。

mcp_config.jsonjson
{
  "mcpServers": {
    "aurabase": {
      "command": "npx",
      "args": ["-y", "-p", "@aurabase/mcp-server", "aurabase-mcp"],
      "env": {
        "AURABASE_URL": "https://<slug>.aurabase.cloud",
        "AURABASE_PROJECT_ID": "<uuid>",
        "AURABASE_SERVICE_ROLE_KEY": "aura_sk_…"
      }
    }
  }
}

ローカルの Docker/k3d スタックに対して、 AURABASE_URL を http://localhost:8080に設定します。

HTTPモード(ローカルサーバー)

ローカル HTTP サーバーを起動し (上記を参照)、その URL と --auth-token 値をベアラー トークンとして追加します。

カーソル — .cursor/mcp.json または ~/.cursor/mcp.json:

.cursor/mcp.jsonjson
{
  "mcpServers": {
    "aurabase": {
      "url": "http://127.0.0.1:3001/mcp",
      "headers": {
        "Authorization": "Bearer my_secret_token"
      }
    }
  }
}

ウィンドサーフィン — ~/.codeium/windsurf/mcp_config.json (キーは serverUrl):

mcp_config.jsonjson
{
  "mcpServers": {
    "aurabase": {
      "serverUrl": "http://127.0.0.1:3001/mcp",
      "headers": {
        "Authorization": "Bearer my_secret_token"
      }
    }
  }
}

Continue.dev (VS Code & JetBrains with Codestral) — ~/.continue/config.yaml:

config.yamlyaml
models:
  - name: Codestral
    provider: mistral
    model: codestral-latest
    apiKey: MISTRAL_API_KEY

mcpServers:
  - name: aurabase
    url: http://127.0.0.1:3001/mcp
    headers:
      Authorization: Bearer my_secret_token

Mistral AI (エージェントおよびコネクタ) は、パブリック HTTPS URL 経由で MCP サーバーに到達します。ホストされたサービス (https://mcp.aurabase.dev/mcp) を使用しますが、計画されており、まだ稼働していません。

ツールがバックエンドから応答を返すか、エラーを返します。#

決して製造された価値ではありません。このルールは意図的なものではありません。このルールは、無効な URL に対してサーバーを起動するベンチによって CI の実行ごとにチェックされ、わずかなツールが正常に応答した場合は失敗します。各ツールは、応答を出力する前に SDK が検証する出力スキーマも宣言します。

ヒント

読み取り専用モード (--read-only) は、カタログから変更ツールを削除します。 および は、読み取り専用トランザクション (86 個中 37 個のツール) で SQL を実行するように PostgreSQL に指示します。この保証は、クライアント側のフィルター処理だけでなく、エンジンからもたらされます。

フラグと環境変数#

  • --url (AURABASE_URL) — Aurabase インスタンス URL
  • --project-id (AURABASE_PROJECT_ID) — プロジェクト ID
  • --service-role-key (AURABASE_SERVICE_ROLE_KEY) — 管理者キー
  • --read-only (AURABASE_READ_ONLY) — 読み取りツールのみを公開します (37/86)
  • --allowed-tools (AURABASE_ALLOWED_TOOLS) — ホワイトリスト (カンマ区切り)
  • --destructive-policy (MCP_DESTRUCTIVE_POLICY) — 破壊的な SQL 操作の対話型確認: elicit (デフォルト)、token、deny
  • --state-key (MCP_STATE_KEY) — マルチターン確認に署名するキー (≥ 32 バイト)
  • --transport — stdio (デフォルト) または http
  • --port — HTTP トランスポート ポート (デフォルトは 3001)
  • --host — HTTP リスニング インターフェイス (デフォルト 127.0.0.1)
  • --auth-token (AURABASE_MCP_AUTH_TOKEN) — /mcp でトークンが必要 — http モードで必要

ドメインごとに配布#

82 個は単純なプロジェクト キーで公開され、4 個は管理プラン用に予約されています (API キーと list_all_projects — このチャネルがないと体系的に失敗するツールよりもツールがない方が良いです)。

データベース (23)list_tables、describe_table、get_performance_advisors、list_extensions、execute_sql、query_table、insert_rows、update_rows、delete_rows、call_rpc、generate_types、diff_schema、apply_migration、list_migrations、explain_query、analyze_table、get_db_size、list_sql_functions、create_sql_function、drop_sql_function、 list_sql_triggers、create_sql_trigger、drop_sql_trigger
ストレージ (9)list_buckets、get_bucket、create_bucket、list_files、delete_files、move_file、create_signed_url、upload_file、empty_bucket
認証 (7)list_users、get_user、create_user、update_user、delete_user、ban_user、generate_link
通知 (10)send_email、send_push_notification、send_sms、list_notification_logs、get_notification_settings、update_notification_settings、list_notification_templates、create_notification_template、delete_notification_template、get_notification_stats
バックアップ (5)list_backups、create_backup、restore_backup、get_backup_schedule、set_backup_schedule
Edge Functions (6)invoke_function、list_functions、get_function_info、deploy_function、delete_function、set_function_env
RLS (6)list_rls_policies、create_rls_policy、update_rls_policy、drop_rls_policy、toggle_rls、get_security_advisors
AI(5)Index_document、rag_query、vector_search、create_vector_index、ai_completion
可観測性 (4)get_project_metrics、list_slow_queries、list_active_queries、cancel_query
リアルタイム (3)list_realtime_channels、get_realtime_settings、update_realtime_settings
プロジェクト(4)project_info、switch_project、get_active_project、list_all_projects (管理チャネル)
API キー (3)create_api_key、list_api_keys、revoke_api_key (管理チャネル)
ドキュメント (1)search_docs — 埋め込みドキュメントの検索 (英語)

*_sql_function / *_sql_trigger ツールは、 list_functions / deploy_function (Edge Functions WASM、別個のランタイム) とは関係なく、プロジェクト スキーマに保存される実際の PostgreSQL 関数とトリガーを作成します。

URL で接続するクライアントの HTTP モード#

stdio はデフォルトのトランスポートです。 http モード (ストリーミング可能な HTTP、MCP プロトコル 2025-11-25 および 2026-07-28):

  • デフォルトで 127.0.0.1 をリッスンします (変更するには--host )。
  • トークン (--auth-token またはベアラー トークン) が必要です。トークンがないと、サーバーは起動を拒否します。
  • Origin ヘッダーを検証し、未承認の発信元に 403 で応答します (CSRF 対策保護)。
  • セッションごとに 1 つのサーバー インスタンス。有効期限と設定可能な上限あり。
  • トークンを一定時間で比較し、リクエスト本体のサイズを制限します。

さらに進むには#