İçeriğe geç
Aurabase Logosu
aura tabanı

MCP Sunucu

Aurabase arka ucunuzu Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code veya herhangi bir Model Bağlam Protokolü uyumlu istemciden kontrol edin — 86 araç, üretilmiş değer yok.

Referans7 dk. okuSeviye referans18 Eki 2026 tarihinde revize edildi

Bu çeviriden bu yana İngilizce kaynak değişti. Bazı bilgiler güncelliğini kaybetmiş olabilir.
Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

Varsayılan olarak yerel stdio modu, yerel HTTP modu#

Resmi Aurabase MCP sunucusu, arka ucunuzu incelemek ve kontrol etmek için 86 aracı kullanıma sunar (proje anahtarıyla 82 araç). Makinenizde iki moddan birinde çalışır:

  1. stdio modu (varsayılan): MCP istemciniz sunucuyu npx ile bir alt işlem olarak başlatır.
  2. HTTP modu (Akışlı HTTP): bir yerel sunucuyu (http://127.0.0.1:3001/mcp) başlatırsınız ve her istemciyi kendi URL'sine yönlendirirsiniz.

Barındırılan hizmet (https://mcp.aurabase.dev/mcp, OAuth 2.1 ile oturum açma) planlanmıştır, henüz yayınlanmamıştır.

Paketin iki ikili dosyası vardır (aurabase-mcp ve aurabase-mcp-hosted), dolayısıyla npx ikili adına ihtiyaç duyar: npx -y -p @aurabase/mcp-server aurabase-mcp. --project-id gereklidir.

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

Bunun yerine yerel HTTP sunucusunu başlatmak için aktarımı, bağlantı noktasını ve belirteci ekleyin:

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_…

İstemci ve mod başına yapılandırma#

stdio modu (varsayılan)

İmleç (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Google Antigravity (~/.gemini/config/mcp_config.json) ve Cline veya Roo Kodlu VS Kodu (cline_mcp_settings.json) aynı bloğu kullanır:

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_…"
      }
    }
  }
}

Yerel bir Docker/k3d yığınına karşı AURABASE_URL öğesini http://localhost:8080 olarak ayarlayın.

HTTP modu (yerel sunucu)

Yerel HTTP sunucusunu başlatın (yukarı bakın), ardından URL'sini ve --auth-token değerini Taşıyıcı belirteci olarak ekleyin.

İmleç — .cursor/mcp.json veya ~/.cursor/mcp.json:

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

Rüzgar Sörfü — ~/.codeium/windsurf/mcp_config.json (anahtar serverUrl):

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

Continue.dev (Codestral ile VS Code ve JetBrains) — ~/.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 (Aracılar ve Bağlayıcılar), genel bir HTTPS URL'si üzerinden MCP sunucularına ulaşır: planlanan, henüz yayınlanmayan barındırılan hizmeti (https://mcp.aurabase.dev/mcp) kullanır.

Bir araç, arka uçtan gelen yanıtı veya bir hatayı döndürür#

Asla üretilmiş bir değer değildir. Bu kural bir amaç değildir: CI'nin her yürütülmesinde, sunucuyu ölü bir URL'ye karşı başlatan ve en ufak bir aracın başarıyla yanıt vermesi durumunda başarısız olan bir tezgah tarafından kontrol edilir. Her araç ayrıca SDK'nın yanıtı göndermeden önce doğruladığı bir çıkış şeması da bildirir.

İpucu

Salt okunur mod (--read-only), mutasyona uğrayan araçları kataloğundan kaldırır ve, PostgreSQL'ye SQL'i salt okunur bir işlemde yürütmesi talimatını verir (37 araç / 86) — garanti yalnızca istemci tarafı filtrelemeden değil, motordan gelir.

Bayraklar ve ortam değişkenleri#

  • --url (AURABASE_URL) — Aurabase örnek URL'si
  • --project-id (AURABASE_PROJECT_ID) — Proje Kimliği
  • --service-role-key (AURABASE_SERVICE_ROLE_KEY) — Yönetici Anahtarı
  • --read-only (AURABASE_READ_ONLY) — Yalnızca okuma araçlarını gösterir (37 / 86)
  • --allowed-tools (AURABASE_ALLOWED_TOOLS) — Beyaz liste, virgülle ayrılmış
  • --destructive-policy (MCP_DESTRUCTIVE_POLICY) — Yıkıcı SQL işlemlerinin etkileşimli onayı: elicit (varsayılan), token, deny
  • --state-key (MCP_STATE_KEY) — Çok dönüşlü onayları imzalayan anahtar (≥ 32 bayt)
  • --transport — stdio (varsayılan) veya http
  • --port — HTTP aktarım bağlantı noktası (varsayılan 3001)
  • --host — HTTP dinleme arayüzü (varsayılan 127.0.0.1)
  • --auth-token (AURABASE_MCP_AUTH_TOKEN) — /mcp üzerinde jeton gerekli — http modunda gerekli

Etki alanına göre dağıtılır#

82'si basit bir proje anahtarıyla açığa çıkarıldı, 4'ü yönetim planı için ayrıldı (API anahtarları ve list_all_projects - bu kanal olmadan sistematik olarak başarısız olan bir araçtansa hiç araç olmaması daha iyidir).

Veritabanı (23)list_tables, define_table, get_performans_advisors, list_extensions, executive_sql, query_table, insert_rows, update_rows, delete_rows, call_rpc, created_types, diff_schema, application_migration, list_migrations, açıkla_query, analyze_table, get_db_size, list_sql_functions, create_sql_function, drop_sql_function, list_sql_triggers, create_sql_trigger, drop_sql_trigger
Depolama (9)list_buckets, get_bucket, create_bucket, list_files, delete_files, move_file, create_signed_url, upload_file, empty_bucket
Yetkilendirme (7)list_users, get_user, create_user, update_user, delete_user, ban_user, created_link
Bildirimler (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
Yedeklemeler (5)list_backups, create_backup, restore_backup, get_backup_schedule, set_backup_schedule
Edge Functions (6)çağırma_işlevi, liste_işlevleri, get_işlev_bilgisi, konuşlandırma_işlevi, silme_işlevi, set_işlev_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, vektör_arama, create_vector_index, ai_completion
Gözlemlenebilirlik (4)get_project_metrics, list_slow_queries, list_active_queries, cancel_query
Gerçek zamanlı (3)list_realtime_channels, get_realtime_settings, update_realtime_settings
Proje (4)project_info, switch_project, get_active_project, list_all_projects (yönetim kanalı)
API anahtarları (3)create_api_key, list_api_keys, revoke_api_key (yönetim kanalı)
Dokümantasyon (1)search_docs — gömülü belgelerde arama yapın (İngilizce)

*_sql_function / *_sql_trigger araçları, proje şemasında depolanan gerçek PostgreSQL işlevlerini ve tetikleyicilerini oluşturur — list_functions / deploy_function (Edge Functions WASM, ayrı bir çalışma zamanı) ile ilgisi yoktur.

URL ile bağlanan istemciler için HTTP modu#

stdio varsayılan aktarımdır. http modu (Yayınlanabilir HTTP, MCP protokolleri 2025-11-25 ve 2026-07-28):

  • varsayılan olarak 127.0.0.1'yi dinler (bunu değiştirmek için --host);
  • bir belirteç gerektirir (--auth-token veya Taşıyıcı belirteci) — bu olmadan sunucu başlamayı reddeder;
  • Origin başlığını doğrular ve yetkisiz bir kaynağa 403 yanıtı verir (CSRF karşıtı koruma);
  • sona erme tarihi ve yapılandırılabilir sınırla birlikte oturum başına bir sunucu örneği;
  • Belirteçleri sabit zamanda karşılaştırır ve istek gövde boyutunu sınırlar.

Daha ileri gitmek için#