AIREITER모델을 고르기 전에 가격, 컨텍스트 길이, 벤치마크, 실제 제공 엔드포인트까지 한곳에서 확인하고 싶다면 OpenRouter MCP가 유용하다. 에이전트가 최신 모델 카탈로그와 문서를 조회하고 후보 모델을 시험할 수 있게 해 주는 호스팅형 Model Context Protocol 서버다. 다만 운영 환경에서 OpenRouter API를 대체하는 도구는 아니다.
핵심만 먼저: OpenRouter MCP가 바꾸는 것
공식 서버 주소는 https://mcp.openrouter.ai/mcp다. Claude Code, Cursor, Claude Desktop처럼 호환되는 클라이언트에서 원격 HTTP로 연결하면 대화 안에서 OpenRouter 도구를 호출할 수 있다. 모델을 조사하고 시험하는 단계에는 적합하지만, 애플리케이션에 들어갈 운영 호출은 여전히 OpenRouter API 또는 해당 제공업체의 MCP가 맡아야 한다.
| 하려는 일 | 권장 도구 | 이유 |
|---|---|---|
| 가격, 컨텍스트, 모달리티, 벤치마크, 제공업체 조건으로 현재 모델 찾기 | OpenRouter MCP | 실시간 카탈로그와 엔드포인트 데이터를 조회한다 |
| 후보 모델에 동일한 프롬프트 실행하기 | OpenRouter MCP | send-message로 지정한 모델 슬러그를 시험하고 생성 ID를 돌려준다 |
| 자체 제품에서 모델 호출 배포하기 | OpenRouter API | 애플리케이션에서 키, 재시도, 프롬프트, 로깅을 직접 제어할 수 있다 |
| 특정 제공업체의 서비스나 계정 운영하기 | 해당 제공업체의 공식 MCP | OpenRouter가 소유하지 않은 기능까지 노출할 수 있다 |
| 탐색 과정에서 이미지 생성하기 | OpenRouter MCP, 신중하게 사용 | generate-image는 추론 작업이므로 과금될 수 있다 |
OpenRouter의 공식 발표에서는 실시간 모델 데이터, 순위, 가격, 문서, 테스트 추론 기능을 소개한다. 엔드포인트와 도구, 인증 방식은 MCP 문서를 기준으로 확인하면 된다.
서버 주소보다 먼저 정할 워크플로
가장 실용적인 흐름은 찾기, 비교하기, 테스트하기, 확인하기다. 막연한 “최고의 모델이 뭐지?”라는 질문을 명확한 조건을 가진 선택 문제로 바꿔 준다.
- 찾기: 작업 유형, 가격, 컨텍스트, 모달리티, 제공업체 조건에 맞는 모델을 요청한다. 최신 카탈로그와 벤치마크 데이터는
list-models,list-benchmarks로 확인한다. - 비교하기: 후보별로
list-model-endpoints를 호출해 제공업체 단위의 가격, 지연 시간, 처리량, 제공되는 경우 데이터 정책을 살핀다. - 테스트하기: 지정한 모델 슬러그와 동일한 프롬프트로
send-message를 실행한다. 이 단계에는 추론 비용이 발생할 수 있다. - 확인하기: 각 생성 ID를
get-generation에 전달해 토큰 수, 비용, 실제 서빙 제공업체를 확인한다.
Claude Code 또는 Cursor에서는 다음과 같이 요청할 수 있다.
OpenRouter MCP를 사용해 법률 문서에서 구조화된 데이터를 추출할 수 있는
모델 세 개를 찾아줘. 조건은 최소 100k 컨텍스트, 도구 호출 지원,
그리고 이용 가능한 가장 낮은 입력 가격이야. 제공업체와 데이터 정책을 비교해줘.
그다음 가장 적합한 후보 두 개에 정확히 아래 프롬프트를 send-message로 실행해줘:
"아래 텍스트에서 모든 계약 갱신 날짜를 추출해. renewals라는 배열만 포함한 JSON을 반환하고,
각 항목에는 party, date, evidence를 넣어."
테스트 후 각 생성 ID에 get-generation을 사용해 실제 비용과 서빙 제공업체를 보고해줘.
내가 후보를 승인하기 전에는 모델을 호출하지 마.카탈로그 검색은 읽기 전용이지만 send-message에는 추론 비용이 발생할 수 있으므로, 테스트 전 승인을 요구하는 편이 좋다. 반복 가능한 평가가 필요하다면 모델과 제공업체를 명시적으로 지정하자. :free, :floor, :nitro, :online 같은 접미사는 지원되는 경우 라우팅 선호도를 나타낼 뿐, 고정된 품질을 보장하지는 않는다.
공식 원격 서버 연결하기
로컬에 설치할 것은 없다. 원격 엔드포인트를 추가한 뒤 브라우저 기반 OAuth를 완료하고, 다른 키와 분리된 전용 OpenRouter 키를 승인하면 된다. 문서상 기본값은 7일 만료와 $10 지출 한도이며, 승인 화면에서 수정할 수 있다. OpenRouter는 PKCE 기반 OAuth를 사용하므로 일반 API 키를 클라이언트 설정에 붙여 넣는 방식이 아니라 브라우저에서 권한을 부여한다.
Claude Code 연결 방법
다음을 실행한다.
claude mcp add --transport http openrouter https://mcp.openrouter.ai/mcp
claude mcp login openrouter첫 번째 명령은 원격 HTTP 서버를 등록하고, 두 번째 명령은 OAuth 흐름을 연다. Claude Code 세션에서는 Claude Code MCP 문서에 나온 /mcp도 사용할 수 있다. OpenRouter 서버를 선택한 뒤 인증하면 된다.
연결 확인은 다음처럼 읽기 전용 요청으로 시작하면 안전하다. “OpenRouter MCP를 사용해 컨텍스트가 최소 128k인 현재 모델 두 개를 나열하고 입력 가격을 보여줘.”
Cursor 연결 방법
~/.cursor/mcp.json에 원격 서버를 추가한다.
{
"mcpServers": {
"openrouter": {
"url": "https://mcp.openrouter.ai/mcp"
}
}
}서버가 보이지 않으면 Cursor를 다시 불러온다. 인증은 Cursor의 MCP 설정 또는 첫 도구 사용 시 시작된다. 문서화된 CLI는 cursor-agent이며, 다음 명령으로 등록 항목을 확인할 수 있다.
cursor-agent mcp listCursor의 MCP 문서에는 사용자 수준과 프로젝트 수준 설정이 설명되어 있다. 필요한 범위에 맞춰 등록하고, 개인 인증 설정은 공유 저장소에 커밋하지 않는 것이 좋다.
Claude Desktop 및 Claude Web 연결 방법
Claude의 커넥터 디렉터리에 OpenRouter가 없다면, OpenRouter의 연결 가이드는 사용자 지정 원격 커넥터 추가를 안내한다.
- Settings > Connectors > Customize > Connectors를 연다.
- +를 클릭한 뒤 Add custom connector를 선택한다.
- 이름에
OpenRouter MCP를 입력한다. - 원격 MCP 서버 URL로
https://mcp.openrouter.ai/mcp를 입력한다. - OAuth 필드는 비워 둔 채 커넥터를 추가하고, 커넥터를 연 뒤 Connect를 클릭한다.
- OpenRouter 브라우저 승인 절차를 완료한다.
일부 조직은 사용자 지정 커넥터를 비활성화한다. 관리형 계정에서 이 옵션이 보이지 않는다면 관리자에게 확인해야 한다. 클라이언트 측 프로토콜 개념은 Anthropic의 MCP 문서에서 다룬다.
안전하게 요청할 수 있는 작업 범위
공식 OpenRouter MCP 도구 대부분은 실시간 조회 도구다. 전체 목록을 외우기보다 부작용 기준으로 나눠 보면 훨씬 이해하기 쉽다.
| 도구 그룹 | 예시 | 과금 또는 부작용 |
|---|---|---|
| 카탈로그 및 벤치마크 | list-models, get-model, list-benchmarks, list-daily-model-rankings | 읽기 전용 조회 |
| 엔드포인트 및 라우팅 | list-model-endpoints, list-providers | 읽기 전용 조회 |
| 문서 및 계정 | search-docs, get-credits, get-generation | 읽기 전용 조회 |
| 테스트 추론 | send-message | 과금되는 모델 호출 |
| 이미지 탐색 | generate-image | 과금되는 생성 작업 |
| 피드백 | send-feedback | 내 생성 결과 하나에 피드백을 기록 |
모델 선택을 맡길 때는 의사결정 규칙을 분명히 적는다. 예를 들어 “도구 호출을 지원하고 컨텍스트 윈도우가 64k인 모델 중 가장 저렴한 것을 찾은 뒤, 이용 가능한 엔드포인트 중 가장 빠른 것을 보여줘”처럼 요청한다. 문서화된 필터에는 가격, 최소 컨텍스트, 모델 계열, 작성자, 제공업체, 모달리티, 지원 파라미터, 벤치마크 범위, 도구 호출 성공률, 제로 데이터 보존 가능 여부, 리전이 포함된다.
통제된 모델 테스트에서는 슬러그를 지정하고 프롬프트를 재현 가능하게 작성한다.
OpenRouter MCP send-message를 모델 "openai/gpt-4o"와 함께 사용해줘.
정확히 아래 사용자 메시지만 보내고 시스템 프롬프트는 추가하지 마:
"title과 risks 키를 가진 JSON 객체를 반환해. 다음 릴리스 노트를 분석해:
[여기에 텍스트 붙여넣기]"
응답과 생성 ID를 보여줘. 다른 모델은 실행하지 마.위 슬러그는 예시이므로, 실제 사용 전 list-models로 이용 가능 여부를 확인해야 한다. 감사 가능한 비교를 하려면 근거 없는 모델 추천을 받아들이지 말고, 조회 도구와 반환값, 생성 ID를 명시적으로 요구하자.
OpenRouter MCP와 공식 제공업체 MCP, 무엇이 다른가
OpenRouter MCP는 여러 제공업체를 가로지르는 모델 조사·테스트 계층이다. 반면 공식 제공업체 MCP는 해당 제공업체의 제품, 계정, 데이터 플레인 안에서 이뤄지는 작업에 대체로 더 적합하다.
| 판단 기준 | OpenRouter MCP | 공식 제공업체 MCP |
|---|---|---|
| 모델 선택 | 하나의 카탈로그에서 여러 제공업체의 모델을 비교 | 대개 한 제공업체의 모델 또는 서비스에 집중 |
| 가격 및 라우팅 | 제공업체 간 가격, 엔드포인트, 폴백 옵션을 비교 | 제공업체 자체 계정과 라우팅 규칙을 사용 |
| 도메인 작업 | OpenRouter가 노출하는 도구로 제한 | 제공업체가 소유한 파일, 프로젝트, 작업, 계정 관련 작업에 유리 |
| 이식성 | 하나의 원격 엔드포인트를 여러 MCP 클라이언트에서 사용 가능 | 클라이언트 설정과 제공업체 범위는 서비스마다 다름 |
| 자격 증명 경계 | 만료일과 한도가 있는 전용 OpenRouter OAuth 키 | 제공업체별 OAuth 또는 API 자격 증명 |
| 운영 애플리케이션 트래픽 | OpenRouter API를 계속 사용 | 제공업체 API 또는 지원되는 운영용 통합 방식 사용 |
질문이 “어떤 모델 또는 라우트를 써야 할까?”라면 OpenRouter MCP를 선택하면 된다. “이 제공업체 서비스 안에서 무엇을 할 수 있나?”가 질문이라면 퍼스트파티 제공업체 MCP가 맞다. 두 기능이 모두 필요하다면 같은 에이전트에 함께 연결할 수도 있다.
커뮤니티가 만든 로컬 또는 멀티모달 MCP 서버는 별도 범주다. OpenRouter의 Works With OpenRouter 페이지는 여러 클라이언트와 텍스트, 이미지, 오디오, 비디오 워크플로를 지원하는 서버 하나를 소개한다. 이 서버는 OpenRouter API 키와 크레딧이 필요하며, mcp.openrouter.ai에서 제공하는 공식 호스팅 서비스와는 다르다.
실제 프로젝트에서 중요한 경계
| 고려 사항 | 어떻게 작동하나 | 권장 대응 |
|---|---|---|
| 애플리케이션 통합 | MCP는 개발 단계의 조사와 테스트용이며 일반적인 제품 트래픽용은 아니다 | 운영 코드에서는 https://openrouter.ai/api/v1를 직접 호출 |
| 추론 과금 | send-message와 generate-image는 MCP 키의 한도를 사용할 수 있지만, 조회 도구는 추론 호출을 하지 않는다 | 테스트 전까지 기본 한도를 유지하고, 승인을 요구하며, 각 생성 ID를 확인 |
| 소스 및 프롬프트 데이터 | OpenRouter의 MCP 문서에 따르면 소스 코드는 기본적으로 전송되지 않지만, 과금 호출에 명시적으로 포함한 콘텐츠는 선택한 모델에 전달될 수 있다 | 테스트에 필요한 텍스트만 전송 |
| 제공업체 선택 | 가격, 지연 시간, 가용성 변화에 따라 동적 라우팅이 실제 서빙 제공업체를 바꿀 수 있다 | 재현 가능한 평가나 필수 데이터 정책이 있다면 제공업체를 고정 |
“@OpenRouter’s ori harness/cli has been a blessing... p.s: also thanks for openrouter mcp for quickly checking up info on models 🫰” — @CodewithP, X, 모델 정보 조회 활용 사례를 언급하며.
OpenRouter의 MCP cookbook에서는 반대 방향의 활용도 다룬다. 즉 코딩 클라이언트를 OpenRouter MCP에 연결하는 대신, 다른 MCP 도구 서버의 LLM 백엔드로 OpenRouter 모델을 사용하는 방식이다.
첫 호출이 실패했을 때 점검할 것
- 서버는 보이는데 도구 인증이 실패한다. 클라이언트별 OAuth 절차를 다시 실행한다. 전용 키의 문서상 수명은 7일이며, OpenRouter 대시보드에서 연결을 해제할 수도 있다.
- 브라우저 창이 열리지 않는다.
claude mcp login openrouter, Claude Code의/mcp동작, Cursor의 MCP 설정, 또는 Claude 커넥터의 Connect 버튼을 사용한다. - Claude Desktop에 사용자 지정 커넥터 옵션이 없다. 조직 관리자가 사용자 지정 커넥터를 비활성화했는지 확인한다.
- 모델 정보가 오래된 것처럼 보인다.
list-models,list-benchmarks,list-model-endpoints를 명시적으로 요청하고 반환값도 요구한다. - 테스트 비용이 예상보다 높거나 다른 곳으로 라우팅됐다.
get-generation으로 생성 ID를 확인한 뒤, 다음 재현성 테스트에서는 제공업체를 명시적으로 고정한다.
FAQ
OpenRouter MCP로 모든 OpenRouter 모델을 호출할 수 있나?
실시간 카탈로그에 노출된 모델 슬러그는 가용성, 기능, 크레딧, 라우팅 조건의 제약 아래 테스트할 수 있다. 먼저 list-models로 슬러그를 확인하자.
Claude Desktop, Cursor, Claude Code에서 OpenRouter MCP를 동시에 쓸 수 있나?
각 클라이언트의 문서화된 설정 및 인증 흐름을 따르면 모두에 같은 공식 엔드포인트를 추가할 수 있다. 공유 설정에는 개인 자격 증명을 포함하지 않아야 한다.
대신 커뮤니티 openrouter-mcp 패키지를 설치해야 하나?
공식 호스팅 서버가 제공하지 않는 로컬 stdio 워크플로나 멀티모달 오케스트레이션이 필요한 경우에만 고려할 만하다. 설치 전에는 저장소, 자격 증명 처리 방식, 패키지 출처, 유지보수 상태를 확인해야 한다.
처음에는 읽기 전용 카탈로그 조회부터 시작하고, 모델과 라우트, 지출 한도가 명확해진 뒤에만 통제된 추론 호출을 승인하자.