Notion MCP 서버를 Teleport에 연결

요약

Teleport can provide secure access to MCP servers via Teleport Application Service. In this guide, you will: Notion MCP 서버는 통합 토큰을 사용하여 Notion에 접근하고 Teleport 애플리케이션 서비스가 접근할 수 있는 로컬 엔드포인트에서 실행됩니다.

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

In this guide, you will:

Configure your Notion service for access by the MCP server.
Run the Notion MCP Server.
Enroll the MCP server into your Teleport cluster and connect to it.

작동 방식#

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

사전 요구사항#

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:

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

1/3단계. Notion에서 통합 생성#

https://www.notion.so/profile/integrations로 이동하여 새 내부 통합을 생성합니다.

Notion 통합

LLM에서 사용 가능한 범위를 제한하려면 "Capabilities" 섹션에서 "Read Content"를 제외한 모든 권한을 비활성화합니다.

그런 다음 "Access" 탭을 열고 통합이 접근할 수 있는 페이지를 선택합니다.

Notion 접근

마지막으로 "Configuration" 탭으로 돌아가 다음 단계에서 사용하기 위해 "Internal Integration Secret"을 복사합니다.

2/3단계. Notion MCP 서버 실행#

Notion 통합 토큰 을 사용하여 Notion MCP 서버를 시작합니다:

$ export NOTION_TOKEN=
$ npx @notionhq/notion-mcp-server --transport http --port 8000 --auth-token teleport-local-connection

MCP 서버는 기본적으로 모든 네트워크 인터페이스에서 수신합니다. 프라이빗 네트워크에서 실행하고 호스트명 가 Teleport 애플리케이션 서비스에서 접근할 수 있는지 확인합니다.

--auth-token 값은 Teleport가 MCP 서버에 인증하는 데 사용하는 공유 시크릿입니다. MCP 서버는 공개적으로 접근할 수 없으므로 고정 값을 사용하는 것이 허용됩니다.

3/3단계. Teleport를 통한 연결#

You can register an MCP application in Teleport by defining it in your Teleport Application Service configuration, or by using dynamic registration with tctl or Terraform:

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: notion-mcp-readonly
spec:
  allow:
    app_labels:
      'service': 'notion'
    mcp:
      tools:
      - API-get-*
      - API-retrieve-*
      - API-post-database-query
      - API-post-search

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 notion-mcp --client-config claude

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

Notion Claude

다음 단계#

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