직접 연결

직접 연결은 내가 운영하는 서버, 곧 원격 MCP 서버나 HTTP API 를 에이전트에 잇습니다. 엔드포인트와 필요한 헤더를 endue 에 알려 주면, 연결을 붙인 에이전트가 그 서버를 부를 수 있습니다.

언제 쓰는가

카탈로그에 커넥터가 없는 서비스에 씁니다. 사내 API, 직접 만든 MCP 서버, 팀이 만든 도구 같은 것입니다. 연결 가능한 서비스에 있는 서비스라면 그 커넥터를 쓰세요. 작업이 이미 분류돼 있어서 발송과 삭제만 먼저 묻습니다.

MCP 서버와 HTTP 서버

	MCP 서버	HTTP 서버
엔드포인트	Streamable HTTP 전송을 쓰는 서버의 MCP 엔드포인트	기준 URL
에이전트가 받는 것	서버가 알려 주는 도구 하나하나. 이름과 설명은 서버 것을 씁니다	기준 URL 아래 경로로 GET·POST·PUT·PATCH·DELETE 를 보내는 요청 도구 하나
설명	선택. 목록에서 서버를 알아보기 쉽게 적어 둡니다.	필수. 에이전트가 이 글을 읽고 어떤 경로와 메서드를 쓸지 압니다.

직접 연결 추가하기

좌측 사이드바에서 리소스 › 커넥터를 열고 직접 연결 탭에서 직접 연결 추가를 누릅니다.
방식을 고릅니다. MCP 서버 또는 HTTP 서버입니다. 저장한 뒤에는 바꿀 수 없습니다.
칸을 채웁니다.
- 이름: 목록과 대화에 보이는 이름.
- 엔드포인트 URL: 인터넷에서 닿는 https:// 주소. HTTP 서버라면 기준 URL 이고, 에이전트는 그 아래 경로로만 요청합니다.
- 헤더: 서버가 요구하는 헤더를 한 줄에 하나씩. 예: Authorization 에 Bearer ….
- 설명: HTTP 서버라면 에이전트가 알아야 할 것을 적습니다. 경로, 메서드, 예시입니다. 예: GET items?q=검색어 로 항목을 찾고, POST items 에 {"title": "…"} 를 보내 항목을 만든다.
연결 확인을 누릅니다. 아직 저장하지 않습니다.
- MCP 서버라면 서버 이름, MCP 프로토콜 버전, 서버가 제공하는 도구, 그리고 에이전트가 쓸 수 없는 도구와 그 이유가 보입니다.
- HTTP 서버라면 endue 가 기준 URL 로, 또는 확인할 경로를 적었다면 그 아래 경로로 GET 요청을 한 번 보내고, 상태 코드와 응답 앞부분을 보여 줍니다.
저장을 누릅니다. MCP 서버는 저장하면서 도구 목록을 받습니다. 서버에 닿지 못하면 아무것도 저장하지 않습니다.
에이전트에 붙입니다. 그 에이전트의 에이전트 빌더에서 리소스 › 커넥터를 열고 다른 연결처럼 고릅니다. 직접 연결 배지와 호스트가 함께 보입니다.

헤더

토큰 같은 헤더 값은 암호화해 저장합니다. 저장한 뒤에는 나에게도 다시 보여 주지 않고, 에이전트와 대화에도 나오지 않습니다. endue 가 요청마다 직접 붙이고, 에이전트가 헤더를 더할 수는 없습니다.

편집할 때 값을 비워 두면 그대로 두고, 새 값을 적으면 바뀝니다. 저장한 값은 브라우저로 돌려보내지 않으므로, 이미 있는 연결에서 연결 확인을 하려면 헤더 값을 모두 다시 적어야 합니다.

Host·Content-Length·Connection, 그리고 Proxy-·CF-·X-Forwarded-·Mcp- 로 시작하는 헤더는 연결이 직접 관리하므로 넣을 수 없습니다.

승인

직접 연결 호출은 기본적으로 매번 승인을 받습니다. endue 는 내 서버의 도구가 무엇을 하는지 모르고, 서버가 도구에 붙인 설명을 묻지 않아도 될 이유로 삼지 않습니다.

묻지 않고 실행되게 하려면 직접 연결 탭에서 그 연결의 편집을 누르고 항상 허용을 켭니다.

MCP 서버: 도구별로.
HTTP 서버: 메서드별로. 예: GET.

루틴·채널처럼 지켜보는 사람이 없는 실행은 항상 허용한 것만 쓸 수 있습니다. 그런 실행에서 나머지 호출은 거절됩니다.

네트워크 규칙

endue 는 내 컴퓨터가 아니라 자기 인프라에서 서버를 부릅니다. 서버가 인터넷에서 닿아야 합니다.

https:// 만, 포트 443 또는 8443.
공인 도메인 이름. IP 주소, localhost, 사설 주소로 풀리는 이름, endue 자신의 주소는 받지 않습니다. 아이디·비밀번호가 들어간 URL 도 받지 않으니 자격 증명은 헤더로 넣으세요.
리다이렉트는 같은 호스트로만 따라갑니다.
호출마다 30초입니다. HTTP 응답은 256KB 에서 잘립니다. MCP 응답이 256KB 를 넘으면 실패합니다. 256KB 를 넘는 요청 본문은 보내지 않습니다.

요청은 Cloudflare 네트워크에서 나갑니다. 서버에 방화벽이나 허용 목록이 있다면 Cloudflare 의 IP 대역을 허용하세요.

연결 관리하기

직접 연결 탭에 연결마다 방식, 호스트, 도구 수, 상태, 쓰는 에이전트가 보입니다.

다시 받기는 MCP 서버의 도구 목록을 다시 읽습니다. 서버의 도구를 바꾼 뒤에 누르세요. 엔드포인트나 헤더를 바꿀 때도 목록을 다시 받습니다.
오류는 마지막으로 서버에 닿으려 했을 때 실패했다는 뜻입니다. 연결을 열면 이유가 보입니다.
삭제는 저장한 헤더 값을 지우고, 이 연결을 쓰던 모든 에이전트에서 뺍니다. 되돌릴 수 없습니다.

한계

계정당 직접 연결 20개까지.
MCP 서버는 Streamable HTTP 전송을 써야 합니다. 옛 HTTP+SSE 전송을 쓰거나 OAuth 로그인을 요구하는 서버는 지원하지 않습니다.
HTTP 서버는 에이전트에게 요청 도구 하나와 내 설명을 줍니다. OpenAPI 문서는 읽지 않습니다. JSON·텍스트 응답을 다루고, 파일 업로드나 스트리밍 응답은 다루지 않습니다.
사설망의 서버에는 닿지 않습니다. 서버에 공인 HTTPS 주소가 있어야 합니다.
입력 형식을 에이전트가 쓸 수 없는 도구는 빠지고, 이유와 함께 쓸 수 없는 도구로 표시됩니다.
직접 연결은 내 계정에 속합니다. 카탈로그에는 나타나지 않습니다.