Pumati 설치: 에이전트용 안내

당신은 AI 에이전트이고, 사용자가 Pumati 설정을 부탁했어요. 아래 단계를 순서대로 따르세요. 직접 실행할 수 있는 명령은 직접 실행하세요. 사용자가 해야 하는 단계(브라우저 로그인, 설정 화면)는 무엇을 하면 되는지 정확히 알려 주고 기다리세요.

https://mcp.pumati.app/mcp

1. 이미 설치돼 있는지 확인

• Claude Code: claude mcp get pumati.
• Codex: codex mcp list에서 pumati를 찾으세요.
• Cursor: ~/.cursor/mcp.json과 프로젝트의 .cursor/mcp.json에서 pumati 항목을 찾으세요.
• Gemini CLI: gemini mcp list.
• VS Code: 사용자 MCP 설정(MCP: Open User Configuration)과 워크스페이스의 .vscode/mcp.json에서 pumati를 찾으세요.

pumati가 https://mcp.pumati.app/mcp로 이미 있으면 4단계로 넘어가세요. 다른 주소로 있으면 바꾸기 전에 사용자에게 물어보세요.

2. 어떤 클라이언트에서 실행 중인지 판별

• Claude Code(claude를 실행할 수 있음): 3단계의 Claude Code.
• Codex CLI 또는 Codex 앱(codex를 실행할 수 있음, 설정은 ~/.codex/config.toml): 3단계의 Codex.
• Cursor: 3단계의 Cursor.
• Gemini CLI(gemini를 실행할 수 있음): 3단계의 Gemini CLI.
• VS Code의 GitHub Copilot: 3단계의 VS Code.
• Claude Desktop·claude.ai, ChatGPT, 또는 설정 화면에서 서버를 추가하는 앱: 직접 추가할 수 없어요. Claude, ChatGPT, 기타 클라이언트의 단계를 사용자에게 알려 주고, 사용자가 마치면 5단계로 이어 가세요.
• 잘 모르겠으면: 어떤 앱을 쓰는지 사용자에게 물어보세요.

3. 서버 추가

Claude Code

claude mcp add pumati --scope user --transport http https://mcp.pumati.app/mcp

Codex

codex mcp add pumati --url https://mcp.pumati.app/mcp

Cursor

~/.cursor/mcp.json에 pumati 항목을 추가하세요. 파일에 이미 있는 서버는 그대로 두세요.

{
  "mcpServers": {
    "pumati": {
      "url": "https://mcp.pumati.app/mcp"
    }
  }
}

Gemini CLI

gemini mcp add --transport http --scope user pumati https://mcp.pumati.app/mcp

VS Code

사용자 MCP 설정(MCP: Open User Configuration)에 pumati 항목을 추가하세요. 이미 있는 서버는 그대로 두세요.

{
  "servers": {
    "pumati": {
      "type": "http",
      "url": "https://mcp.pumati.app/mcp"
    }
  }
}

4. 사용자 로그인 안내

로그인은 사용자의 브라우저에서 pumati.app OAuth로 해요. 비밀번호나 토큰을 절대 묻지 마세요. 사용자는 동의 화면에서 이 연결에 줄 앱, 권한, 지출 한도를 골라요.

• Claude Code: 사용자에게 /mcp를 열고 pumati를 골라 Authenticate를 누르라고 하세요(터미널에서는 claude mcp login pumati). 이번 세션에서 추가한 서버라면 Claude Code를 다시 시작해야 할 수 있어요.
• Codex CLI: codex mcp login pumati를 실행하면 사용자의 브라우저가 열려요. Codex 앱에서는 사용자가 Settings → MCP servers에서 pumati 옆 Authenticate를 눌러요.
• Cursor: 사용자에게 Cursor의 MCP 설정을 열고 pumati에 로그인하라고 하세요.
• Gemini CLI: 사용자에게 Gemini CLI에서 /mcp auth pumati를 실행하라고 하세요.
• VS Code: Pumati 도구를 처음 쓸 때 사용자의 브라우저가 열려요.

5. 연결 확인

list_apps를 호출하세요. 이 연결이 쓸 수 있는 앱과 권한, 읽기 권한이 있는 앱마다 빌드와 최근 테스트(다른 도구에 넘길 id 포함), 지출 한도가 나와요. 새 계정이면 빈 목록이 정상이에요(사용자가 허용했다면 upsert_app으로 앱을 만들 수 있어요). Pumati 도구가 아직 보이지 않으면 클라이언트를 다시 시작하거나 새 세션을 열어야 할 수 있어요.

• SUBSCRIPTION_REQUIRED: 계정에 MCP 요금제가 필요해요(구독). 사용자가 pumati.app/dev/credits에서 골라요.
• FORBIDDEN: 이 연결에 그 앱이 없거나 철회됐어요. 사용자에게 다시 로그인해 필요한 앱을 허용해 달라고 하세요.

6. 사용자에게 보고

어떤 클라이언트와 어떤 설정 파일을 바꿨는지, 로그인이 끝났는지, list_apps 결과(앱, 권한, 지출 한도)를 알려 주세요. 사용자가 더 해야 할 일이 있으면 말하세요. 그다음 첫 작업으로 아래 중 하나를 제안하세요.