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로 설치할 수 있습니다.