MCP

MCP

Mistral MCP 서버는 AI 에이전트를 Model Context Protocol을 통해 Studio 워크스페이스에 연결해 줘요. 워크스페이스를 MCP 도구로 노출시키고, 각 요청을 Mistral API 키로 인증해요.

코딩 CLI, IDE, 데스크톱 어시스턴트, 여러분의 애플리케이션 등 에이전트가 실행되는 어디서든 사용할 수 있어요.

출처: 문서

본문
Endpoint https://api.mistral.ai/mcp
Transport Streamable HTTP
Authentication Authorization: Bearer ***

시작하기 전에 (Before you begin)

  • Mistral API 키. 키는 워크스페이스 스코프로 적용되므로, 에이전트는 그 키가 이미 가진 접근 권한을 그대로 얻게 돼요.
  • Streamable HTTP 전송과 정적 요청 헤더를 지원하는 MCP 클라이언트.

클라이언트를 실행하는 환경에서 키를 내보내세요:

export MISTRAL_API_KEY="your_api_key"

클라이언트 연결하기 (Connect a client)

Vibe Code CLIClaude CodeCodexOther clientscurl

vibe mcp add mistralai \
  --url https://api.mistral.ai/mcp \
  --transport streamable-http \
  --api-key-env MISTRAL_API_KEY

이 명령은 ~/.vibe/config.toml에 항목을 기록해요:

[[mcp_servers]]
name = "mistralai"
transport = "streamable-http"
url = "https://api.mistral.ai/mcp"

[mcp_servers.auth]
type = "static"
api_key_env = "MISTRAL_API_KEY"

설정에는 변수 이름이, 환경에는 키 값이 저장되는 구조예요. 세션에서 /mcp mistralai를 실행하면 도구 목록이 나와요. 권한과 도구 필터링은 MCP servers를 참고하세요.

서버가 노출하는 것 (What the server exposes)

Skills — Studio›Skills ↗에서 관리하는 재사용 가능한 지시문 세트예요. 에이전트는 워크스페이스 카탈로그를 둘러보고, Skill과 함께 제공되는 파일을 읽고, 새 Skill 버전을 만들고, 공유 대상을 바꾸거나 삭제할 수 있어요. 에디터에서 작성한 Skill은 Studio에 나타나고, Studio에서 작성한 Skill은 에이전트가 사용할 수 있어요.

Skills가 첫 번째 기능이고 더 많은 기능이 뒤따를 거예요. 서버는 여러분의 키에 사용 가능한 도구 목록을 제공하므로, 클라이언트에 도구 목록을 요청하거나 tools/list를 호출해 보세요. 각 도구는 자기 인자를 설명해 줘요.

접근 및 권한 (Access and permissions)

모든 호출은 여러분의 API 키 권한을 사용해요.

일부 도구는 쓰기 작업을 수행해요. Skill 버전 추가, 공유 변경, Skill 삭제 같은 것들이요. 이런 호출을 실행 전에 검토하려면 클라이언트에서 도구별 승인(per-tool approval)을 구성하세요.

문제 해결 (Troubleshooting)

Problem Cause Solution
401 {"detail":"Invalid API Key"} 키가 없거나, 오타가 있거나, 폐기됐어요. 클라이언트를 실행하는 환경에서 변수를 내보내고, 콘솔에서 키가 활성 상태인지 확인하세요.
도구 호출이 권한 오류를 반환해요. 작업에 추가 워크스페이스 접근이 필요해요. 워크스페이스 관리자에게 해당 접근 권한을 요청한 뒤 다시 시도하세요.

다음 단계 (Next steps)

더 알아보기 (Learn more)