자체 MCP 서버 연결

사용자 정의 도구 사용: 원격 MCP 서버를 등록하면 해당 서버의 도구들을 에이전트에 연결할 수 있습니다. "MCP 서버 생성" 도구는 의도적으로 존재하지 않습니다. 서버를 등록한다는 것은 해당 서버가 사용자의 테넌트에서 실행되는 것을 신뢰한다는 의미이므로, 이는 에이전트가 자체적으로 수행하는 작업이 아니라 콘솔(또는 REST 호출)에서 의도적으로 수행하는 작업입니다.

1. 서버 등록

콘솔에서: Tools / MCP → Add MCP server — 서버 이름을 지정하고, 전송 방식(Streamable HTTP 또는 SSE)과 URL, 인증 헤더를 선택합니다.

또는 REST API를 통해(테넌트 키 사용, $BASE = https://api.agent4.io/v1):

curl -X POST $BASE/mcp-servers -H "X-API-Key: $KEY" -H 'Content-Type: application/json' \
  -d '{"name":"my-tools","transport":"streamable_http",
       "config":{"url":"https://tools.example.com/mcp","headers":{"Authorization":"Bearer …"}}}'

원격 전송 방식만 허용됩니다. stdio(로컬 명령)는 거부됩니다. 서버는 사용자의 머신이 아닌 플랫폼에서 실행되므로, 로컬 명령은 사용자에게 무용지물일 뿐만 아니라 코드 실행 위험도 있습니다.

2. 도구 확인

list_mcp_servers()   # the MCP servers registered on your tenant
list_tools()         # every tool you can attach to an agent, including the ones from your servers

3. 에이전트에 도구 연결

update_agent(name="Support", add_tools=["…"])   # incremental; use tool names exactly as list_tools() reports them

에이전트는 이제 대화 중에 해당 도구를 호출할 수 있습니다. 관련성 있는 소수의 도구를 집중적으로 사용하는 것이 큰 더미보다 낫습니다(참조: Design principles).