MCP로 연결

Umtri는 https://mcp.umtri.io에서 Model Context Protocol 서버를 호스팅합니다. 아무 MCP 클라이언트든 이 주소를 가리키게 하고 umtri_pat_… 토큰을 Bearer 헤더로 넣으면 됩니다 — 클론이나 설치가 없습니다. 토큰을 먼저 발급하세요(API 토큰 발급 참고).

Claude Code

claude mcp add --transport http umtri https://mcp.umtri.io \
  --header "Authorization: Bearer umtri_pat_xxxxxxxxxxxxxxxx"

모든 프로젝트에 적용하려면 --scope user(전역), 현재 프로젝트만이면 --scope local. claude mcp list로 확인하면 umtri: ✓ Connected가 보이고, 세션 안에서 /mcp로 도구 목록을 볼 수 있습니다.

Gemini CLI

gemini mcp add --transport http \
  --header "Authorization: Bearer umtri_pat_xxxxxxxxxxxxxxxx" \
  umtri https://mcp.umtri.io

--scope user(전역) 또는 --scope project로 범위를 정합니다.

Codex

Codex는 토큰을 환경변수로 참조합니다. 변수를 설정한 뒤 ~/.codex/config.toml(전역) 또는 .codex/config.toml(프로젝트)에 서버를 추가하세요:

export UMTRI_API_TOKEN="umtri_pat_xxxxxxxxxxxxxxxx"

# ~/.codex/config.toml
[mcp_servers.umtri]
url = "https://mcp.umtri.io"
bearer_token_env_var = "UMTRI_API_TOKEN"

모든 MCP 클라이언트 (JSON)

설정 객체를 받는 클라이언트는 같은 형태를 씁니다:

{
  "mcpServers": {
    "umtri": {
      "type": "http",
      "url": "https://mcp.umtri.io",
      "headers": { "Authorization": "Bearer umtri_pat_xxxxxxxxxxxxxxxx" }
    }
  }
}

로컬 실행 (stdio)

서버를 직접 실행하고 싶다면 — 버전 고정이나 자체 호스팅 API 연결 등 — umtri-mcp 패키지가 stdio로 동작합니다. 클라이언트가 UMTRI_API_TOKEN을 환경변수로 전달합니다.

claude mcp add umtri \
  -e UMTRI_API_TOKEN=umtri_pat_xxxxxxxxxxxxxxxx \
  --transport stdio \
  -- npx -y umtri-mcp

소스: github.com/bepuljang/umtri-mcp — Apache-2.0.

기타 변수

• UMTRI_API_BASE — 기본값 https://api.umtri.io. API를 자체 호스팅할 때만 변경.