NeboAI
NeboAI
시작하기

MCP

Model Context Protocol은 AI 시스템에 도구를 제공하는 표준 방식입니다. Nebo는 양방향으로 작동합니다. 봇이 MCP 서버에 연결해 직원이 그 도구를 쓸 수 있고, 다른 MCP 클라이언트가 봇에 연결해 Nebo의 도구를 쓰고 직원과 대화할 수 있습니다.

MCP 서버 연결하기

소유자는 Nebo 설정의 MCP 페이지에서 서버를 추가하거나, 마켓플레이스에서 CONN- 코드로 커넥터를 설치합니다. Nebo는 MCP 서버가 게시하는 표준 구성 블록도 받아들이며, mcpServers 키와 servers 키 모두 지원합니다.

{
  "mcpServers": {
    "files": {
      "command": "example-files-mcp",
      "args": ["--root", "/Users/me/Documents"],
      "env": { "LOG_LEVEL": "info" }
    },
    "tickets": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}
설정값
전송 방식stdio(command, args, env가 있는 로컬 명령), http 또는 sse(선택적 headers가 있는 URL).
인증none, api_key 또는 oauth.
OAuthNebo는 서버의 인증 엔드포인트를 찾고, 서버가 동적 클라이언트 등록을 지원하면 스스로 등록하며, S256 방식의 PKCE를 사용하고, 토큰이 만료되기 전에 갱신하며, 토큰을 암호화해 저장합니다.

직원에게 MCP 도구가 보이는 방식

연결된 서버의 각 도구는 mcp__<server>__<tool>이라는 이름의 도구가 되며, 봇의 모든 직원이 사용할 수 있고 직원이 필요할 때 로드됩니다. MCP 도구도 다른 모든 도구와 같은 승인 절차를 따릅니다. 소유자의 규칙은 도구 하나나 mcp__tickets__*처럼 서버 전체를 지정할 수 있습니다. 기능과 승인을 참조하세요.

Nebo를 MCP 서버로 사용하기

실행 중인 봇은 로컬 주소의 POST /agent/mcp에서 JSON-RPC와 MCP 프로토콜 버전 2025-03-26으로 MCP 요청에 응답합니다. 봇의 도구와, 직원에게 메시지를 보내고 기록을 읽고 세션을 관리하는 nebo 도구를 제공합니다. 모든 요청에는 자격 증명이 필요합니다. NEBO_MCP_API_KEY 또는 봇 데이터 폴더의 .install-key에서 읽은 봇의 설치 키입니다.

MCP 서버를 로컬 명령으로 시작하는 클라이언트를 위해, nebo mcp serve는 실행 중인 봇과 이어지는 표준 입출력 브리지를 실행하고 키도 직접 제공합니다.

nebo mcp serve --tools read_file,run_command
nebo mcp serve --exclude-tools desktop
명령하는 일
nebo mcp serve표준 입출력을 실행 중인 봇에 연결합니다.
--tools a,b나열된 도구만 제공합니다.
--exclude-tools x나열된 도구를 숨깁니다.
nebo mcp config --target <client>지원되는 클라이언트용 구성 블록을 출력합니다.

NEBO_ALLOW_REMOTE=true로 시작하지 않는 한, 봇은 자기 컴퓨터에서만 수신 대기합니다.

NeboAI MCP 서버

NeboAI 자체도 마켓플레이스 게시용 MCP 서버를 https://neboai.com/mcp에서 운영합니다. 게시를 참조하세요.