클라이언트 연결하기

Tiro MCP 서버 주소는 https://mcp.tiro.ooo/mcp예요. 아래에서 사용하는 클라이언트의 설정 방법을 확인하세요.

API key가 없다면 Tiro Platform API Keys 페이지에서 만드세요. abc123.xR7mK9pL2qW4...처럼 점(.)을 포함한 전체 문자열을 복사해야 해요. 전체 키는 생성할 때 한 번만 볼 수 있어요.

Claude (웹 브라우저)

claude.ai를 브라우저에서 사용한다면 설치 없이 원격 커넥터로 연결해요. OAuth 전용이에요 (API Key 입력란이 없어요).

claude.ai/customize/connectors의 Connectors → Discover에서 Tiro를 검색하세요.
Tiro(Community, by ThePlato Inc.) 카드에서 Connect Tiro to Claude를 누르세요.
Tiro 계정으로 로그인하고 권한을 허용하세요. 연결 후 도구 실행은 기본적으로 건건이 승인을 물어봐요 (커넥터 설정에서 도구별 Always allow로 변경 가능).

서버 URL(https://mcp.tiro.ooo/mcp)을 직접 넣는 Add custom connector 경로도 그대로 동작해요.비개발자용 단계별 안내(스크린샷 포함 예정)는 사용자 가이드에 있어요.

Claude Desktop

권장: OAuth. 한 번 로그인하면 클라이언트가 token을 관리해요.

Node.js가 필요해요. mcp-remote 패키지가 streamable-http를 Claude Desktop이 기대하는 stdio transport로 연결해 줘요.

플랫폼에 맞는 설정 파일을 여세요.

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

~/.config/Claude/claude_desktop_config.json

OAuth 설정을 추가하세요.

claude_desktop_config.json

{
  "mcpServers": {
    "tiro": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tiro.ooo/mcp"]
    }
  }
}

Claude Desktop을 재시작하세요. 처음 연결할 때 브라우저가 열리며 Google 로그인 후 Tiro consent 화면에서 허용할 권한을 scope 단위 체크박스로 선택해요 (읽기는 기본 선택, 쓰기는 기본 해제이며 쓰기를 선택하면 같은 리소스의 읽기가 포함돼요). token은 로컬에 캐시되며 180일간 유효해요.대체: API Key. 브라우저 흐름을 원하지 않으면 다음을 사용하세요.

claude_desktop_config.json

{
  "mcpServers": {
    "tiro": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.tiro.ooo/mcp",
        "--header", "Authorization:Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude Code (CLI)

권장: API Key. 브라우저 의존성이 없고 교체하기 쉬워요.

claude mcp add --transport http tiro-mcp https://mcp.tiro.ooo/mcp \
  --header "Authorization:Bearer YOUR_API_KEY"

대체: OAuth. --header를 생략하세요. Claude Code가 처음 연결할 때 브라우저를 열어요.

claude mcp add --transport http tiro-mcp https://mcp.tiro.ooo/mcp

ChatGPT

2026년 7월 개편으로 ChatGPT의 외부 연결은 앱·플러그인 체계로 바뀌었어요. 플러그인 디렉토리에 없는 커스텀 MCP 서버(Tiro 포함)는 developer mode에서만 연결할 수 있어요.웹 전용(모바일 미지원)이고, 개인 계정은 Pro 플랜부터 read/fetch 범위로 연결할 수 있어요. Business는 admin/owner만, Enterprise·Edu는 RBAC로 권한을 받은 멤버만 developer mode를 쓸 수 있어요.

Settings → Plugins → 목록 맨 아래 Developer mode → 보안 설정에서 Developer mode 토글을 켜세요.
사이드바 Plugins 페이지의 [+] → New Plugin에서 이름과 서버 URL https://mcp.tiro.ooo/mcp를 입력하고, risk 고지 체크 후 Create를 누르세요.
Sign in with Tiro → Tiro 계정 로그인 → 권한 화면에서 Long-lived access를 체크(ChatGPT가 refresh를 요구해 체크해야 허용 버튼이 활성화됨) → Allow selected access.
대화의 도구 메뉴에서 앱을 선택해 사용하세요. 선택은 메시지 단위로 적용돼요. (2026-09-11 실화면 검증)

상세 요건과 워크스페이스 배포(publish) 절차는 OpenAI 공식 안내를 참고하세요. UI는 베타라 바뀔 수 있어요.

Codex (CLI)

권장: API Key. Codex는 stdio 기반이라 mcp-remote로 감싸요. ~/.codex/config.toml에 추가하세요.

~/.codex/config.toml

[mcp_servers.tiro]
command = "npx"
args = [
  "-y", "mcp-remote",
  "https://mcp.tiro.ooo/mcp",
  "--header", "Authorization:Bearer YOUR_API_KEY"
]

대체: OAuth. --header 두 줄을 지우면 처음 연결할 때 브라우저가 열려요.

Cursor

권장: API Key.

Settings > MCP를 여세요.
Add new MCP server를 클릭하세요.
transport를 HTTP로 설정하세요.
서버 URL https://mcp.tiro.ooo/mcp를 입력하세요.
header를 추가하세요: Authorization: Bearer YOUR_API_KEY.

VS Code (Copilot)

권장: API Key. workspace에 .vscode/mcp.json을 만들거나 편집하세요.

.vscode/mcp.json

{
  "servers": {
    "tiro": {
      "type": "http",
      "url": "https://mcp.tiro.ooo/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

기타 MCP 클라이언트

streamable-http를 지원하는 모든 MCP 클라이언트는 아래 원본 값으로 동작해요.

Field	Value
Server URL	`https://mcp.tiro.ooo/mcp`
Transport	HTTP (streamable)
Auth header	`Authorization: Bearer YOUR_API_KEY`
OAuth issuer	`https://mcp.tiro.ooo` (클라이언트가 OAuth 2.0 with PKCE를 지원하는 경우)

stdio만 지원하는 클라이언트라면 endpoint를 mcp-remote로 감싸세요.

npx -y mcp-remote https://mcp.tiro.ooo/mcp \
  --header "Authorization:Bearer YOUR_API_KEY"

권한 범위

권한 범위는 MCP 서버가 접근할 수 있는 리소스를 정의해요. MCP scope는 REST API scope에 mcp: prefix를 붙인 같은 어휘예요. 클라이언트가 도구를 조회하면 연결에 선택된 scope로 허용된 도구만 보여요.

권한 범위	설명
`mcp:note:read`	노트 메타데이터, 요약, transcript, 생성 문서, 공유 링크, 문서 템플릿, 위키 조회 — 위키·템플릿 도구는 별도 scope 없이 이 scope 하나로 게이팅돼요
`mcp:folder:read`	사용자 및 워크스페이스 폴더 구조 검색
`mcp:note:write`*	노트 제목 수정
`mcp:folder:write`*	폴더 수정·이동·정렬

* 현재 MCP에는 이 권한 범위에 대응하는 도구가 없어요(REST API 전용, MCP 도구는 모두 읽기 전용이에요).

API Key: 키에 설정한 scope가 그대로 적용돼요. API Keys 페이지에서는 mcp: 를 뺀 REST 표기(note:read, folder:write 등)로 선택해요 — mcp: prefix는 MCP 표면(auth_status 등)에서만 붙어요. scope를 지정하지 않은 키는 모든 도구를 쓸 수 있고, write scope는 대응하는 read를 포함해요.
OAuth: 연결 시 Tiro consent 화면에서 노트·폴더별로 없음 또는 읽기 중 하나를 선택해요. MCP OAuth 흐름은 write scope(mcp:notes:write, mcp:folders:write)를 요청하지 않으므로(위 표의 * 참고 — 대응하는 MCP 도구가 없어요) 읽기 및 편집 수준은 나타나지 않아요. 선택한 범위는 토큰에 고정돼요.

이전 표기(mcp:notes:read, mcp:folders:read)로 발급된 기존 토큰과 키도 계속 동작해요.

API Key 종류

API Key 종류	묶이는 대상	접근 범위
사용자 범위 API Key	한 명의 사용자	사용자가 접근할 수 있는 모든 노트, 요약, 문서, 폴더. 여러 워크스페이스에 걸칠 수 있음
워크스페이스 범위 API Key	하나의 워크스페이스	해당 워크스페이스에서 전체 구성원에게 공유된 폴더의 노트. 사용자 신원 없음

어떤 키가 필요한가요? 대부분 사용자 범위 API Key로 시작해요. 사용자가 속한 모든 워크스페이스에서 접근 권한이 있는 노트를 검색하고 읽을 수 있어요. 워크스페이스 범위 API Key는 연결된 워크스페이스만 검색하고, 그 안에서도 전체 구성원에게 공유된 폴더의 노트만 조회해요(시스템 API Key가 조회하는 노트 범위). 개인 폴더의 노트가 필요하면 사용자 범위 API Key를 쓰세요. MCP 도구는 REST API 와 같은 키를 쓰고 같은 조회 범위 규칙을 따라요. 폴더 도구(search_private_folders, search_team_folders)에는 사용자 신원이 있는 자격 증명(사용자 범위 API Key 또는 OAuth token)과 mcp:folder:read 권한이 필요해요.

API Key는 Tiro Platform API Keys 페이지에서 폐기하지 않는 한 만료되지 않아요. 개발용과 운영용 키를 분리하고 주기적으로 교체하세요. OAuth 토큰은 180일간 유효해요. 교체하려면 클라이언트에서 로그아웃한 뒤 다시 로그인하세요. 즉시 폐기해야 한다면 지원팀에 문의하세요. 연결되면 사용 가능한 도구를 살펴보세요. 클라이언트가 연결되지 않으면 문제 해결로 이동하세요.

홈

시작하기

API

음성 파일

웹훅

MCP

CLI

개발자 리소스

클라이언트 연결하기

권한 범위

API Key 종류

​권한 범위

​API Key 종류

권한 범위

API Key 종류