커스텀 MCP 서버
Rephlo의 카탈로그에 있는 커넥터 외에도, 사용자가 직접 운영하거나 신뢰하는 사람이 운영하는 커스텀 MCP 서버를 연결할 수 있습니다. 이는 이미 MCP 서버와 접근 토큰을 보유한 고급 사용자를 위한 기능입니다.
커스텀 서버는 데스크톱 앱의 Settings → Connectors → Add custom connector에서 추가합니다. 이 기능에는 웹 UI가 없으며, 모든 작업이 사용자의 컴퓨터에서 로컬로 이루어집니다.
시작하기 전에
다음이 필요합니다.
- 접근 가능한 MCP 서버(그 명령어 또는 URL).
- 인증이 필요한 경우, 해당 서버의 베어러 토큰(bearer token).
현재 인증 방식은 베어러 토큰만 지원됩니다. 커스텀 서버는 현재 사전에 공유된 단일 베어러 토큰으로 인증합니다 — 토큰을 붙여넣으면 Rephlo가 이를 각 요청과 함께 전송합니다. Notion처럼 브라우저를 통해 로그인하는 OAuth 기반 커스텀 서버는 아직 지원되지 않으며, 이후 릴리스에서 제공될 예정입니다.
커스텀 서버 추가하기
- Settings → Connectors를 열고 Add custom connector를 클릭합니다.
- 나중에 알아볼 수 있도록 서버에 이름을 지정합니다.
- Rephlo가 서버와 통신하는 방식인 **전송 방식(transport)**을 선택합니다.
- Streamable HTTP — Rephlo가 네트워크를 통해 서버 URL에 연결합니다.
- Stdio — Rephlo가 로컬 실행 파일을 실행하여 사용자의 컴퓨터에서 직접 통신합니다.
- 전송 방식별 세부 설정을 입력합니다(아래 표 참고).
- 서버의 베어러 토큰을 붙여넣습니다.
- 저장합니다. Rephlo가 연결되어 서버에 어떤 도구를 제공하는지 확인하며, 서버의 도구가 채팅에서 사용 가능해집니다.
전송 방식 선택과 베어러 토큰 필드가 있는 Add custom connector 패널입니다.
전송 방식 설정
| 전송 방식 | 필수 | 선택 |
|---|---|---|
| Streamable HTTP | 서버 URL | 인증을 위한 베어러 토큰 |
| Stdio | 실행할 실행 파일 경로 | 인수(Arguments) |
Rephlo 자체 커넥터 카탈로그는 추가 검증을 위해 일부 서버를 SHA-256 바이너리 해시로 고정하지만, 이는 Rephlo 측에서 관리하는 것으로 사용자가 커스텀 커넥터를 추가할 때 설정하는 필드가 아닙니다.
데이터가 저장되는 위치
- 커스텀 서버와 베어러 토큰은 사용자의 기기에 암호화되어 저장됩니다. Rephlo 백엔드로는 전송되지 않습니다.
- 커스텀 서버의 도구 호출은 데스크톱에서 서버로 직접 실행되며, Rephlo의 클라우드를 거치지 않습니다.
- 다른 모든 커넥터와 마찬가지로 도구 결과는 세션 중에만 메모리에 존재하며, 로컬 감사 로그에는 도구 이름, 소요 시간, 상태만 기록되고 인수나 내용은 절대 기록되지 않습니다.
문제 해결
서버가 연결을 거부합니다(401 / unauthorized). 베어러 토큰이 잘못되었거나 갱신되었을 수 있습니다. 서버를 제거하고 올바른 토큰으로 다시 추가하세요.
연결이 시간 초과됩니다. 서버 URL에 접속할 수 있는지, 서버가 적절히 빠르게 응답하는지 확인하세요 — 도구 호출에는 고정된 시간 제한이 있습니다. 서버가 단순히 느린 경우 성능이나 가용성을 점검하세요.
도구가 표시되지 않거나 도구 호출이 파싱되지 않습니다. 서버는 유효한 MCP를 구사해야 하며, Rephlo가 연결될 때 자신의 도구를 선언해야 합니다. 서버가 형식이 올바른 MCP 도구 정의와 응답을 반환하는지 확인하세요.