Подключение клиента

Все MCP-клиенты запускают локальный сервер одинаково: выполняют команду и общаются с ней через stdio. До удалённых серверов клиенты добираются по URL через Streamable HTTP. Во всех конфигурациях ниже используйте абсолютные пути.

Claude Code#

# local, over stdio
claude mcp add weather -- node /absolute/path/main.ts

# remote, over HTTP
claude mcp add --transport http weather https://example.com/mcp

Добавьте --scope project, чтобы записать сервер в .mcp.json и поделиться им с командой.

Claude Desktop#

Отредактируйте claude_desktop_config.json (Настройки → Разработчик → Изменить конфигурацию) и перезапустите приложение:

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/absolute/path/main.ts"]
    }
  }
}

Cursor#

Создайте .cursor/mcp.json в проекте или ~/.cursor/mcp.json для всех проектов:

{
  "mcpServers": {
    "weather": { "command": "node", "args": ["/absolute/path/main.ts"] },
    "remote-weather": { "url": "https://example.com/mcp" }
  }
}

VS Code#

Создайте .vscode/mcp.json:

{
  "servers": {
    "weather": { "type": "stdio", "command": "node", "args": ["/absolute/path/main.ts"] },
    "remote-weather": { "type": "http", "url": "https://example.com/mcp" }
  }
}

MCP Inspector#

npx @modelcontextprotocol/inspector node /absolute/path/main.ts

Чтобы отладить HTTP-сервер, запустите его через serve({ http: 3000 }), откройте Inspector, выберите Streamable HTTP и введите http://127.0.0.1:3000/mcp. Inspector работает на localhost, а picomcp разрешает его по умолчанию.

Bun и Deno#

Замените node на свою среду выполнения:

{ "command": "bun", "args": ["/absolute/path/main.ts"] }

{ "command": "deno", "args": ["run", "--allow-net", "/absolute/path/main.ts"] }

Решение проблем#

Клиент не показывает ни одного инструмента. Выполните команду из конфигурации сами. Если она завершается или выводит ошибку, клиент видит то же самое.

«Unexpected token» или ошибки JSON в логе клиента. Что-то записало в stdout. При работе через stdio picomcp перенаправляет console.log в stderr, но другие библиотеки могут писать в process.stdout напрямую.

Node не запускает файлы .ts. Обновитесь до Node 22.18 или новее либо запускайте сервер через Bun.