> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tiro.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트에 Tiro MCP 설치하기

> 프롬프트 하나면 에이전트가 Tiro MCP 서버를 설치하고, OAuth로 로그인시키고, 연결을 확인해요.

아래 블록을 Claude Desktop, Claude Code, Cursor, ChatGPT, 또는 MCP 호환 클라이언트에 붙여넣으세요. 에이전트가 지침을 읽고 `https://mcp.tiro.ooo/mcp`에 연결한 뒤, 처음 사용할 때 브라우저로 로그인시켜요.

**호환 클라이언트**  ·  Claude Desktop  ·  Claude Code  ·  Cursor  ·  ChatGPT  ·  VS Code (Copilot)  ·  streamable-HTTP를 지원하는 모든 MCP 클라이언트

## 이 프롬프트를 복사하세요

```text The Tiro MCP install prompt theme={"system"}
Install the Tiro MCP server in this workspace.

  Server URL :  https://mcp.tiro.ooo/mcp
  Transport  :  HTTP (streamable)
  Auth       :  OAuth (preferred). On first connection, open a browser
                for Google sign-in. Tokens cache locally for 180 days.

If this client cannot run a browser flow, ask me for a Tiro API key
from https://platform.tiro.ooo/dashboard/api-keys and attach the
header:

  Authorization: Bearer <TIRO_API_KEY>

For stdio-only clients, wrap the endpoint with mcp-remote:

  npx -y mcp-remote https://mcp.tiro.ooo/mcp

After connecting, list the Tiro tools that loaded and call
`auth_status` to confirm the session is live. If a step fails, show
me the exact error and the step where it happened — do not retry
silently.
```

<Tip>
  이 프롬프트는 의도적으로 **클라이언트에 종속되지 않게** 작성됐어요. 에이전트가 실행 중인 환경에 따라 적절한 설정 파일(`claude_desktop_config.json`, `.vscode/mcp.json`, Cursor 설정 등)을 알아서 선택해요.
</Tip>

## 에이전트가 하는 일

1. 활성화된 MCP 클라이언트를 감지하고 해당 설정 파일을 열어요.
2. `https://mcp.tiro.ooo/mcp`를 가리키는 `tiro` 서버 항목을 추가해요.
3. 클라이언트를 재시작하고(또는 재시작을 요청하고) 브라우저에서 OAuth를 완료해요.
4. `auth_status`를 호출해 연결을 확인하고 어떤 도구가 사용 가능한지 보고해요.

문제가 생기면 에이전트가 정확한 오류를 그대로 보여주므로 어느 단계를 다시 시도해야 할지 알 수 있어요. 조용히 반복 시도하는 일은 없어요.

## 개인정보 및 token 처리

* OAuth token은 로컬 MCP 클라이언트 설정에만 캐시되고, 다른 어디에도 전송되지 않아요.
* API key를 대체 수단으로 사용하는 경우 같은 설정 파일에 평문으로 저장돼요. 공유되는 dotfile에는 넣지 마세요.
* 둘 다 [API Keys 대시보드](https://platform.tiro.ooo/dashboard/api-keys)에서, 또는 클라이언트에서 로그아웃하여 언제든 폐기할 수 있어요.

***

직접 설정하고 싶으신가요?  → [클라이언트별 수동 설정](/ko/developers/mcp/setup)   ·   [사용 가능한 도구](/ko/developers/mcp/tools/overview)   ·   [문제 해결](/ko/developers/mcp/troubleshooting)