MCP 서버
원격 MCP 서버를 연결하면 서버가 제공하는 모든 도구를 각각 직접 정의하지 않아도 대화 중 에이전트에서 사용할 수 있습니다.
이미 Model Context Protocol을 지원하는 도구 서버를 실행 중이라면
ThunderPhone에 직접 연결할 수 있습니다. 연결 → MCP (/dashboard/mcp-connections)에서
서버를 한 번 추가하면 도구가 자동으로 검색되며 모든 에이전트에 연결할 수 있습니다.
ThunderPhone은 Streamable HTTP를 통해 MCP 서버에 연결합니다. 지원되는 전송 방식은 이것뿐이므로 서버는 HTTP URL에서 접근할 수 있어야 합니다(stdio 전용 로컬 서버는 작동하지 않습니다).
서버 추가
- 서버 추가를 클릭합니다
서버의 이름과 URL을 입력합니다(예:
https://example.com/mcp). - 서버에 필요한 경우 헤더를 추가합니다
서버에 필요한 정적 HTTP 헤더를 추가합니다. 일반적으로
Authorization헤더입니다. UI에서는 헤더 값을 조회할 수 없으므로, 나중에 서버를 수정할 때 기존 값을 유지하려면 값을 비워 둡니다. - 저장하고 동기화합니다
저장하면 즉시 서버의 도구 목록이 동기화됩니다. 서버 카드에는 검색된 모든 도구가 이름으로 표시됩니다. 아무것도 표시되지 않으면 서버는 응답했지만 도구를 제공하지 않은 것입니다.
서버 관리
각 서버 카드에는 URL과 캐시된 도구 목록이 표시되며, 다음 작업을 할 수 있습니다.
- 서버를 삭제하지 않고 활성화/비활성화합니다.
- 도구 동기화 — 서버가 변경된 후 도구 목록을 다시 가져옵니다.
- 이름, URL 또는 헤더를 수정합니다.
- 서버를 삭제합니다.
에이전트에 연결
연결된 서버는 에이전트가 사용하기 전까지 아무 작업도 하지 않습니다. 빌더에서 에이전트를 열고(에이전트 구축) MCP 섹션에서 서버를 연결합니다. 그러면 해당 서버의 도구를 그 에이전트의 대화 중에 호출할 수 있습니다.