MCP 서버

Markdown으로 보기

MCP 서버는 Claude Code·Cursor 같은 바깥 에이전트가 MCP 로 내 endue 에이전트를 찾아보고 일을 시키는 주소입니다. 대화·채널·에이전트 API에 이은 네 번째 진입로이고, 이쪽은 다른 에이전트용입니다.

https://platform.endue.ai/mcp

언제 쓰는가

이미 쓰고 있는 코딩 에이전트가 일하다가 내 endue 에이전트의 도움이 필요할 때입니다. Claude Code 가 코드를 고치는 중에, 고객 문의를 맡은 내 에이전트에게 지난주 환불 문의를 요약해 달라고 묻는 식입니다.

부르는 쪽이 직접 짠 코드라면 에이전트 API가 맞습니다. 그쪽은 답을 스트림으로 받습니다.

연결하기

설정 → 계정 → MCP 연결에서 연결 만들기를 누릅니다. 에이전트 빌더의 MCP 섹션에도 같은 버튼이 있습니다.
키를 만듭니다. 이름과 만료를 정합니다. 권한은 조회와 MCP 실행으로 정해져 있습니다.
설정을 붙여 넣습니다. 쓰는 클라이언트를 고르면 키가 채워진 설정이 나옵니다. 복사해서 안내된 자리에 넣으세요. 키는 이 창을 닫으면 다시 볼 수 없습니다.
연결을 확인합니다. 바깥 에이전트가 첫 요청을 보내면 창이 연결됐습니다로 바뀝니다.
실행할 에이전트에서 MCP 를 켭니다. 에이전트 빌더의 MCP 섹션에서 MCP 로 이 에이전트 실행을 켭니다. 켜지 않은 에이전트는 정보만 읽힙니다.

연결 창이 보여 주는 설정은 아래와 같습니다. sk_... 자리에 발급한 키가 들어갑니다.

터미널에서 실행합니다.

claude mcp add --transport http endue https://platform.endue.ai/mcp --header "Authorization: Bearer sk_..."

~/.cursor/mcp.json 에 넣습니다.

{
  "mcpServers": {
    "endue": {
      "url": "https://platform.endue.ai/mcp",
      "headers": { "Authorization": "Bearer sk_..." }
    }
  }
}

.vscode/mcp.json 에 넣습니다.

{
  "servers": {
    "endue": {
      "type": "http",
      "url": "https://platform.endue.ai/mcp",
      "headers": { "Authorization": "Bearer sk_..." }
    }
  }
}

서버 주소와 헤더를 직접 넣습니다. 전송 방식은 HTTP 입니다.

https://platform.endue.ai/mcp
Authorization: Bearer sk_...

키를 설정 파일에 적고 싶지 않으면 연결 창에서 환경변수로 보기를 누르세요. 키를 ENDUE_API_KEY 에 두고 쓰는 설정으로 바뀝니다.

바깥 에이전트가 쓰는 툴

툴	하는 일	필요한 것
`list_agents`	내 에이전트의 이름·소개와, MCP 로 실행할 수 있는지를 돌려줍니다.	조회 권한
`get_agent`	에이전트 하나의 구성을 요약해 돌려줍니다. 모델, 스킬, 커넥터, 채널이 들어갑니다.	조회 권한
`invoke_agent`	에이전트에게 일을 시키고 답을 받습니다.	MCP 실행 권한과 그 에이전트의 MCP 스위치
`get_session`	앞서 시킨 일의 상태와 답을 다시 받습니다.	MCP 실행 권한

get_agent 는 이름과 요약만 줍니다. 시스템 프롬프트와 메모리의 내용, 커넥터에 연결한 계정은 나가지 않습니다.

invoke_agent 의 답에는 세션 id 가 함께 옵니다. 다음 호출에 그 id 를 보내면 같은 대화에서 이어집니다. 실행이 약 50초 안에 끝나지 않으면 running 상태와 세션 id 가 먼저 가고, 바깥 에이전트가 get_session 으로 답을 받아 갑니다. 바깥 에이전트가 먼저 연결을 끊어도 실행은 끝까지 돕니다.

에이전트마다 정하는 것

에이전트 빌더의 MCP 섹션에 스위치가 둘 있습니다. 둘 다 처음에는 꺼져 있습니다.

MCP 로 이 에이전트 실행. 켜야 invoke_agent 가 통합니다. 꺼져 있어도 이름·소개 같은 정보는 읽힙니다.
커넥터 · 아웃풋도 쓰게 하기. 꺼 두면 MCP 로 들어온 일에는 커넥터와 아웃풋을 쓰지 않습니다. 켜도 보내기·지우기는 매번 승인을 받고, 항상 허용은 여기에 적용되지 않습니다.

같은 섹션의 최근 호출에 이 에이전트로 들어온 MCP 호출이 남습니다. 거절된 호출도 권한 없음, 꺼져 있음 같은 이유와 함께 보입니다.

들어온 일 확인하기

알림. 바깥 에이전트가 새 대화를 시작하면 알림이 한 번 옵니다. 같은 대화가 이어지는 동안에는 다시 오지 않습니다.
대화. 사이드바에서 그 에이전트의 MCP 구획에 모입니다. 대화를 열면 어느 키와 어느 클라이언트가 불렀는지 위쪽에 보입니다.
승인. 승인이 필요한 행동에서 실행이 멈추고 내게 요청이 옵니다. 승인하면 실행이 이어지고, 바깥 에이전트는 get_session 으로 답을 받습니다.

MCP 대화는 읽기 전용입니다. MCP 호출로만 이어집니다.

한계

헤더에 토큰을 넣을 수 없는 클라이언트(OAuth 로만 붙는 것)는 연결하지 못합니다.
MCP 로 들어온 일에는 디바이스를 쓰지 않습니다. 스위치로도 열 수 없습니다.
바깥 에이전트는 모델이나 단계 수를 정하지 못합니다. 에이전트에 정해 둔 대로 돕니다.
에이전트의 질문 카드는 바깥으로 나가지 않습니다. 물을 것이 있으면 에이전트가 답 안에 글로 묻습니다.
바깥 호출자는 에이전트의 메모리에 쓰지 못합니다.
MCP 로 시작한 세션은 MCP 로만 잇고 읽습니다. 에이전트 API 의 세션과 섞이지 않습니다.
list_agents 는 에이전트 50개까지 돌려줍니다.
키의 권한은 발급한 뒤 바꿀 수 없습니다. 다른 권한이 필요하면 새 키를 만드세요.
실행과 과금은 키를 만든 계정으로 됩니다.