MCP 서버 사용하기
MCP 서버 사용하기 (MCP Server Usage)
인기 있는 서드파티 MCP 서버를 LiteLLM MCP Gateway를 통해 연결하는 설정 가이드예요.
출처: 문서
본문
인기 있는 서드파티 MCP 서버를 LiteLLM MCP Gateway를 통해 연결하는 설정 가이드 모음이에요.
각 가이드는 서버의 엔드포인트, LiteLLM이 필요한 인증, 등록 방법, 에이전트에서 도구에 접근하는 방법을 다뤄요. 게이트웨이는 벤더와 무관하게 모든 서버를 동일하게 취급해요: 모든 클라이언트가 하나의 엔드포인트를 쓰고, 키·팀·조직별 권한, 도구 호출별 비용 추적, 단일 감사 추적(audit trail)을 제공해요.
공유 엔드포인트, 전송, 인증 규칙은 MCP Configuration Reference를 참고하세요.
서버 (Servers)
| 서버 | 엔드포인트 | 인증 | 다루는 내용 |
|---|---|---|---|
| Slack | https://mcp.slack.com/mcp |
OAuth 2.1, 자신의 Slack 앱 | 검색, 채널·스레드 읽기, 메시징, 캔버스 |
| Atlassian | https://mcp.atlassian.com/v1/mcp/authv2 |
OAuth 2.1, 동적 등록 | Jira, Confluence, Compass, Jira Service Management, Bitbucket |
| Linear | https://mcp.linear.app/mcp |
OAuth 2.1, 동적 등록 | 이슈, 프로젝트, 사이클, 문서, 코멘트 |
다른 원격 MCP 서버도 같은 구조를 따르면 돼요: url을 해당 서버 엔드포인트로 지정하고, MCP Overview의 인증 표에서 맞는 auth_type을 선택하면 돼요.
이 가이드가 전제하는 것
세 서버 모두 벤더가 호스팅하고 Streamable HTTP를 사용하므로, 직접 설치하거나 실행할 것이 없어요. 세 서버 모두 사용자별 인터랙티브 OAuth로 인증하며, 각 호출자가 브라우저에서 한 번 로그인하고, 도구 호출은 공유 서비스 신원이 아니라 그 개인의 권한을 실어 나른다는 뜻이에요. MCP 서버를 저장하려면 프록시에 store_model_in_db: true가 필요하며, 이는 Prerequisites에서 다뤄요.
config.yaml
general_settings:
store_model_in_db: true
LiteLLM 키를 x-litellm-api-key 헤더에 넣어 주세요.
인터랙티브 OAuth는 업스트림 토큰을 위해 Authorization 헤더가 비어 있어야 해요. 클라이언트가 LiteLLM API 키를 Authorization: Bearer ***로 보내면 OAuth 흐름이 실행되지 않고, 프록시가 사용자의 LiteLLM 키를 Slack·Atlassian·Linear에 그대로 전달해서 거부당해요. 이 세 서버에서 가장 흔한 실패 원인이에요. Debugging OAuth를 참고하세요.
관련 페이지
- 클라이언트 측 패턴: Using your MCP
- 키·팀별 접근 제어: MCP Permission Management
- OAuth 흐름: MCP OAuth
- 도구별 비용: MCP Cost Tracking
- 연결 실패: MCP Troubleshooting Guide