MCP로 연결

MCP로 연결하기

토큰을 발급하면 바로 아래에 ADD UMTRI MCP가 나타나며, 다양한 AI 에이전트와 연동하기 위한 명령어가 미리 작성되어 있습니다. 복사되는 명령어에는 발급한 토큰이 이미 들어 있으니, 버튼을 눌러 복사한 뒤 터미널에 입력하면 연동됩니다. 서비스별 버튼은 크게 Global과 Local(Project)로 나뉩니다(JSON config는 설정 전체를 복사하는 버튼 하나입니다).

• Global: 전역에서 사용 가능하도록 MCP를 추가합니다. 프로젝트마다 추가할 필요가 없어지지만, 그 컴퓨터의 모든 프로젝트가 이 토큰으로 배지를 읽을 수 있고, Write 토큰이면 편집까지 할 수 있습니다.
• Local: 명령을 실행한 프로젝트에 한해 MCP를 추가합니다. 보다 안전하지만, 필요한 프로젝트마다 MCP 추가를 다시 해야 합니다. Codex에서는 이 선택지가 Project로 표시됩니다.

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

Claude Code

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

모든 프로젝트에 적용(Global)하려면 --scope user, 현재 프로젝트만(Local)이면 --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를 자체 호스팅할 때만 변경합니다.

연결 확인하기

어떤 클라이언트를 쓰든, 에이전트에게 “내 Umtri 배지 목록 보여줘” 라고 요청해 보세요. 배지 목록이 돌아오면 연결된 것입니다.