MCP 서버 설정 가이드

개요

unorouter-mcp는 stdio 위에서 MCP 서버로 동작하는 npm 패키지이며 공식 MCP 레지스트리에 com.unorouter/mcp로 등록되어 있습니다. 세 가지 도구를 제공합니다. search_models는 실시간 카탈로그를 필터링하고 free_only 옵션을 지원하며, get_pricing은 100만 토큰당 USD 정가를 반환하고, chat은 아무 모델에나 프롬프트를 보냅니다. 소스 코드는 github.com/0-don/unorouter-mcp에 있습니다.

빠른 설정

이 값들을 클라이언트에 입력하세요. 로그인한 상태에서는 키가 자동으로 채워집니다.

기본 URL: https://api.unorouter.com/v1
API 키: YOUR_API_KEY

호환성

단계별 설정

1. 1
   API 키 발급

   unorouter.com/token에서 키를 만드세요. 서버는 UNOROUTER_API_KEY 환경 변수에서 키를 읽습니다. UNOROUTER_BASE_URL은 선택적인 엔드포인트 재정의입니다.

   bash

   UNOROUTER_API_KEY=YOUR_API_KEY
   UNOROUTER_BASE_URL=https://api.unorouter.com/v1

   API 키를 자동 입력하려면 로그인하세요

2. 2
   Claude Desktop에 서버 추가

   이 블록을 Claude Desktop 설정 파일에 추가하세요. npx가 첫 실행 시 unorouter-mcp를 내려받으므로 미리 설치할 것이 없습니다.

   json

   {
     "mcpServers": {
       "unorouter": {
         "command": "npx",
         "args": ["-y", "unorouter-mcp"],
         "env": { "UNOROUTER_API_KEY": "YOUR_API_KEY" }
       }
     }
   }

   API 키를 자동 입력하려면 로그인하세요

3. 3
   또는 Claude Code에 등록

   명령 하나로 키와 함께 서버가 등록됩니다.

   bash

   claude mcp add unorouter -e UNOROUTER_API_KEY=YOUR_API_KEY -- npx -y unorouter-mcp

   API 키를 자동 입력하려면 로그인하세요

4. 4
   도구 사용

   클라이언트에게 모델 찾기, 가격 비교, 모델에 프롬프트 보내기를 요청하세요. 필요에 따라 search_models, get_pricing, chat을 호출합니다. stdio를 사용하는 MCP 클라이언트라면 모두 동작합니다.

   text

   search_models  filter the live catalog (free_only option)
   get_pricing    USD list prices per 1M tokens
   chat           send a prompt to any model

   API 키를 자동 입력하려면 로그인하세요

추천 모델

여기서 잘 작동하는 무료 모델입니다. 원하는 모델 ID를 클라이언트에 붙여넣으세요.

주의사항

• !:free 접미사가 붙은 모델은 무료입니다. 무료 모델당 분당 약 1회 요청의 속도 제한을 예상하세요.
• !UNOROUTER_API_KEY는 필수입니다. UNOROUTER_BASE_URL은 서버를 다른 엔드포인트로 보낼 때만 설정하세요.
• !레지스트리를 지원하는 MCP 클라이언트는 npx 명령 대신 레지스트리 이름 com.unorouter/mcp로 서버를 설치할 수 있습니다.