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. |
| OAuth | Nebo는 서버의 인증 엔드포인트를 찾고, 서버가 동적 클라이언트 등록을 지원하면 스스로 등록하며, 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에서 운영합니다. 게시를 참조하세요.