본문으로 건너뛰기

MCP 서버 (MCP Servers)

Model Context Protocol(MCP)은 AI 모델, 애플리케이션, 그리고 데이터 도구 소스를 연결하는 개방형 프로토콜 방식입니다. Nexus Agent는 이 프로토콜을 구현하여, 서드파티 서비스 혹은 로컬 도구를 쉽게 활용합니다.

등록 방법​

크게 두 가지 방법으로 서버를 등록할 수 있습니다.

1. 프론트엔드 UI를 통한 등록​

왼쪽 탭의 MCP Servers (/tools) 메뉴로 진입해 우측 상단의 Add 버튼을 눌러 JSON 형태로 등록합니다.

2. mcp.json 텍스트 기반 등록​

초기 설정에서 생성된 ~/.nexus-agent/mcp.json 파일에 직접 추가할 수도 있습니다.

{
  "mcpServers": {
    "example-server": {
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-everything"],
      "enabled": true
    }
  }
}

전송(Transport) 방식 가이드​

Nexus Agent는 다음과 같은 전송 환경을 지원합니다:

Transport 방식필수 필드예시 구성 (JSON)
stdio (기본)command, args"command": "npx", "args": ["-y", "some-mcp-server"]
sseurl"url": "http://localhost:3001/sse"
streamable-httpurl"url": "http://localhost:3001/mcp"

서버가 추가되면 Agent는 해당 서버에 연결 요청을 보내고, 자체적으로 도구(Tool) 목록을 스캔하여 학습합니다. 스캔된 도구들은 채팅 UI 패널 하단 혹은 /tools 페이지에서 실시간으로 확인할 수 있습니다.