Teleport can provide secure access to MCP servers via Teleport Application Service.

In this guide, you will:

1. Configure your HashiCorp Vault service for access by the MCP server.
2. Run the HashiCorp Vault MCP Server.
3. Enroll the MCP server into your Teleport cluster and connect to it.

작동 방식#

HashiCorp Vault MCP 서버는 서비스 토큰을 사용하여 HashiCorp Vault에 접근하고 Teleport 애플리케이션 서비스가 접근할 수 있는 로컬 엔드포인트에서 실행됩니다. Teleport는 모든 클라이언트 요청을 서버로 프록시하며, 서버는 토큰에 바인딩된 정책에 의해 부여된 권한을 사용하여 HashiCorp Vault와 상호작용합니다.

사전 요구사항#

• A running Teleport (v18.3.0 or higher) cluster. If you want to get started with Teleport, sign up for a free trial or set up a demo environment.

• The `tsh` client.

  Installing \`tsh\` client

  1. Determine the version of your Teleport cluster. The `tsh` client must be at most one major version behind your Teleport cluster version. Send a GET request to the Proxy Service at /v1/webapi/find and use a JSON query tool to obtain your cluster version. Replace with the web address of your Teleport Proxy Service:

     $ TELEPORT_DOMAIN=
     $ TELEPORT_VERSION="$(curl -s https://$TELEPORT_DOMAIN/v1/webapi/find | jq -r '.server_version')"
     

  2. Follow the instructions for your platform to install `tsh` client:

• Vault 인스턴스에 대한 접근 권한과 정책을 관리할 수 있는 충분한 권한.
• MCP 서버를 실행할 Teleport 애플리케이션 서비스가 접근할 수 있는 호스트.
• 실행 중인 Teleport 애플리케이션 서비스. 아직 설정하지 않았다면 시작하기 가이드를 따르세요.
• MCP 서버에 접근할 수 있는 충분한 권한을 가진 Teleport 사용자(예: mcp-user 역할).

1/3단계. Vault에서 정책 생성#

먼저 정책 파일을 생성합니다:

$ cat > mcp-readonly.hcl <






To grant access to the MCP server and all its tools, assign the preset
mcp-user role to your Teleport user.
Optionally, you can limit which MCP tools the user can access by adjusting the
mcp.tools list in their role. For example:

kind: role
version: v8
metadata:
  name: vault-mcp-readonly
spec:
  allow:
    app_labels:
      'service': 'vault'
    mcp:
      tools:
      - ^(get|list)_.*$


Now wait until the application appears in tsh mcp ls, then configure your MCP
clients to access the MCP server, for example:
$ tsh mcp config vault-mcp --client-config claude

After configuring your MCP client, you will find Vault-related tools from
teleport-mcp-vault-mcp. You can now use these tools to interactive with
Vault via Teleport in your MCP clients:


다음 단계#

Streamable-HTTP MCP 서버 등록 검토.
동적 등록 가이드 참조.
vault-mcp-server에 대해 자세히 알아보기.
MCP 클라이언트 연결.