본문으로 건너뛰기
아우라베이스 로고
아우라베이스

MCP 서버

Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code 또는 Model Context Protocol 호환 클라이언트에서 Aurabase 백엔드를 제어하세요. 86개 도구, 제조된 가치 없음.

레퍼런스7분 읽기레벨 참조2026. 10. 18.에 개정됨

이 번역 이후 영어 소스가 변경되었습니다. 일부 정보는 최신 정보가 아닐 수 있습니다.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

기본적으로 로컬 stdio 모드, 로컬 HTTP 모드#

공식 Aurabase MCP 서버는 백엔드를 검사하고 제어하기 위한 86개의 도구(프로젝트 키가 있는 82개)를 공개합니다. 이는 두 가지 모드 중 하나로 컴퓨터에서 실행됩니다.

  1. stdio 모드(기본값): MCP 클라이언트는 npx를 사용하여 하위 프로세스로 서버를 시작합니다.
  2. HTTP 모드(스트리밍 가능 HTTP): 하나의 로컬 서버(http://127.0.0.1:3001/mcp)를 시작하고 각 클라이언트를 해당 URL로 지정합니다.

호스팅된 서비스(https://mcp.aurabase.dev/mcp, OAuth 2.1로 로그인)가 계획되어 있지만 아직 활성화되지 않았습니다.

패키지에는 두 개의 바이너리(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_…

클라이언트별 및 모드별 구성#

stdio 모드(기본값)

커서(.cursor/mcp.json), Claude Desktop(claude_desktop_config.json), Windsurf(~/.codeium/windsurf/mcp_config.json), Google Antigravity(~/.gemini/config/mcp_config.json) 및 Cline 또는 Roo Code가 포함된 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 값을 Bearer 토큰으로 추가합니다.

커서 — .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(Codestral이 포함된 VS Code 및 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(에이전트 및 커넥터)는 공개 HTTPS URL을 통해 MCP 서버에 도달합니다. 계획된 호스팅 서비스(https://mcp.aurabase.dev/mcp)를 사용하지만 아직 라이브는 아닙니다.

도구가 백엔드의 응답을 반환하거나 오류를 반환합니다.#

결코 제조된 가치가 아닙니다. 이 규칙은 의도된 것이 아닙니다. CI를 실행할 때마다 작동하지 않는 URL에 대해 서버를 시작하고 사소한 도구라도 성공적으로 응답하면 실패하는 벤치에 의해 확인됩니다. 또한 각 도구는 응답을 내보내기 전에 SDK가 유효성을 검사하는 출력 스키마를 선언합니다.

팁

읽기 전용 모드(--read-only)는 카탈로그에서 변형 도구를 제거하고 PostgreSQL에 읽기 전용 트랜잭션(86개 중 37개 도구)에서 SQL을 실행하도록 지시합니다. 이는 클라이언트 측 필터링뿐만 아니라 엔진에서도 보장됩니다.

플래그 및 환경 변수#

  • --url (AURABASE_URL) — Aurabase 인스턴스 URL
  • --project-id (AURABASE_PROJECT_ID) — 프로젝트 ID
  • --service-role-key (AURABASE_SERVICE_ROLE_KEY) — 관리자 키
  • --read-only (AURABASE_READ_ONLY) — 읽기 도구만 노출합니다(86개 중 37개).
  • --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, explain_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)호출_함수, 목록_함수, get_함수_정보, 배포_함수, 삭제_함수, 설정_함수_env
RLS (6)list_rls_policies, create_rls_policy, update_rls_policy, drop_rls_policy, 토글_rls, get_security_advisors
AI (5)index_document, rag_query, 벡터_검색, 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 또는 Bearer 토큰)이 필요합니다. 토큰이 없으면 서버가 시작을 거부합니다.
  • Origin 헤더를 검증하고 승인되지 않은 원본에 대해 403에 응답합니다(CSRF 방지 보호).
  • 만료 및 구성 가능한 한도가 있는 세션당 하나의 서버 인스턴스
  • 일정한 시간에 토큰을 비교하고 요청 본문 크기를 제한합니다.

더 나아가려면#