MCP

원문 보기 위키 갱신 2026.10.11

MCP (AI 에이전트)

Model Context Protocol을 통해 AI 에이전트를 Turso Cloud에 연결하는 방법이에요. OAuth로 데이터베이스를 관리하고 SQL을 실행할 수 있어서, 복사해 둘 API 토큰이 전혀 필요 없어요.

출처: 문서

본문

Turso는 **https://mcp.turso.ai/mcp**에서 호스팅 Model Context Protocol(MCP) 서버를 운영해요. MCP를 지원하는 어떤 AI 에이전트든 연결하면, 여러분을 대신해 Turso Cloud 계정 — 조직, 데이터베이스, 그룹 — 을 관리하고 SQL을 실행할 수 있어요.

인증은 OAuth 2.1(대시보드 로그인과 같은 방식)이에요: 브라우저에서 접근을 승인하면 에이전트가 스코프가 지정된 토큰을 받아요. 복사하거나 붙여 넣을 API 토큰이 전혀 없어요.

에이전트가 할 수 있는 일

연결되면 에이전트는 다음을 위한 도구를 갖게 돼요:

데이터베이스 — 데이터베이스를 나열하고, 살펴보고, 만들고, 삭제하고, 브랜치를 만들고(시점 브랜치 포함), 구성을 업데이트해요(delete-protection, IP/VPC 허용 규칙, 크기 제한).
SQL — 읽기 전용 쿼리, 쓰기, 삭제, 스키마 변경을 각각 별도 도구로 실행해요. 도구가 분리되어 있어서 에이전트가 작업에 꼭 필요한 만큼만 강한 도구를 쓰게 돼요.
인사이트(Insight) — 데이터베이스별 분석(빈도와 지연 시간 기준 상위 쿼리).
복구(Recovery) — 최근 5일 내에 삭제된 데이터베이스와 그룹을 조회하고 복원해요. 에이전트가 자기 실수를 되돌릴 수 있어요(삭제된 데이터베이스 복구 참고).

읽기 전용 연산과 파괴적 연산에는 라벨이 붙어 있어서, 에이전트가 구분할 수 있고 데이터를 바꾸기 전에 확인을 거칠 수 있어요.

연결하기 (Connect)

Claude Code

플러그인을 설치하고 인증해요:

/plugin marketplace add tursodatabase/turso-mcp
/plugin install turso@turso

/mcp를 실행하고 turso를 선택한 다음 Authenticate를 고르세요. 브라우저가 열리며 접근을 승인하게 돼요(아래 권한 부여 참고).

Codex

플러그인을 설치하고(Turso 스킬도 함께 들어 있어요) 인증해요:

codex plugin marketplace add tursodatabase/turso-mcp
codex plugin add turso@turso
codex mcp login turso

브라우저가 열리며 접근을 승인하게 돼요(아래 권한 부여 참고). MCP 전용 대안: ~/.codex/config.toml에 url = "https://mcp.turso.ai/mcp"인 [mcp_servers.turso]를 추가한 다음 codex mcp login turso를 실행하세요.

Cursor

플러그인을 설치해요(Turso 스킬도 함께 들어 있어요): Customize → Plugins → Add marketplace를 열고 https://github.com/tursodatabase/turso-mcp를 입력한 다음, 그 마켓플레이스에서 Turso를 설치해요. 그다음 Settings → MCP를 열고 turso를 선택한 뒤 로그인 프롬프트에 따라 접근을 승인해요(아래 권한 부여 참고).

원클릭 대안(MCP 서버만, 스킬 없음): Add to Cursor 링크를 쓰거나, ~/.cursor/mcp.json에 서버를 직접 추가해요:

{
  "mcpServers": {
    "turso": { "url": "https://mcp.turso.ai/mcp" }
  }
}

Cursor 웹 및 클라우드 에이전트는 플러그인이나 mcp.json 설정을 읽지 않아요 — 대신 계정에 서버를 한 번 추가하세요: cursor.com/agents에서 모델 선택기 옆 "+" 메뉴 → MCP Servers에 마우스를 올리고 → Add MCP를 눌러 https://mcp.turso.ai/mcp를 입력해요.

Claude (웹 및 데스크톱)

Turso MCP 서버를 가리키는 커스텀 커넥터를 추가해요:

Settings → Connectors → Add custom connector를 열어요.
URL을 https://mcp.turso.ai/mcp로 설정하고 연결해요.
브라우저에서 접근을 승인해요(아래 권한 부여 참고).

기타 MCP 클라이언트

원격(Streamable HTTP) 서버와 OAuth를 지원하는 어떤 MCP 클라이언트든 다음 주소를 가리키세요:

https://mcp.turso.ai/mcp

클라이언트가 인증 서버를 자동으로 발견하고(RFC 9728 / RFC 8414) 같은 브라우저 승인 절차를 안내해요.

접근 권한 부여 (Authorize access)

브라우저가 열리면 Turso에 로그인하고(아직이 아니라면) 에이전트가 무엇에 접근할 수 있는지를 고르는 동의 화면에 도착해요:

조직(organization);
선택적으로 토큰을 제한할 단일 그룹(group) — 아니면 전체 조직으로 전체 접근;
그룹을 골랐다면 권한(permissions) (읽기 전용, 전체 접근, 또는 커스텀 집합).

승인하면 에이전트가 연결돼요. 스코프를 다시 정하거나 조직을 바꾸려면 연결을 끊고 다시 인증하세요(Claude Code에서는 /mcp → turso → Clear authentication).

그룹을 고르면 토큰이 그 그룹의 자원으로 스코프가 좁혀져요 — 최소 권한 선택이에요. "Entire organization"은 전체 접근을 부여해요. 어느 쪽이든 토큰은 Turso API에서 강제돼요: 모든 도구 호출은 조직 바인딩, 역할, 스코프를 검사받고 감사 로그에 기록돼요.

동작 방식 (How it works)

MCP 서버는 자체 권한을 갖지 않아요. 각 도구는 여러분의 토큰을 들고 일반 Turso 플랫폼 API로 요청을 전달하기 때문에, 다른 API 접근과 동일한 인가·감사 규칙이 적용돼요.
토큰은 조직 또는 그룹으로 스코프돼요. 스코프 없는 토큰은 거절돼요.
동의는 Turso 대시보드 — 로그인 세션을 볼 수 있는 유일한 곳 — 에서 이뤄지고, 거기서 에이전트가 사용할 스코프 토큰이 발행돼요.

참고 자료 (Resources)

플러그인 소스와 에이전트별 설정: github.com/tursodatabase/turso-mcp

MCP