← Создание агентов на Cloudflare / agents / model-context-protocol / guides

Тестирование удалённого MCP-сервера

Удалённые авторизованные подключения остаются развивающейся частью Спецификация Model Context Protocol (MCP) ↗. Не все MCP-клиенты пока поддерживают удалённые подключения.

Это руководство покажет вам варианты того, как начать использовать ваш удалённый MCP-сервер с MCP-клиентами, поддерживающими удалённые подключения. Если вы ещё не создали и не развернули удалённый MCP-сервер, вам следует сначала выполнить действия из Создайте удалённый MCP-сервер руководством для начала.

@modelcontextprotocol/inspector пакет ↗ это визуальный инструмент для тестирования MCP-серверов.

1. Откройте терминал и выполните следующую команду:

   npx @modelcontextprotocol/inspector

   🚀 MCP Inspector is up and running at:
   	http://localhost:5173/?MCP_PROXY_AUTH_TOKEN=46ab..cd3
   
   🌐 Opening browser...

   MCP Inspector запустится в вашем веб-браузере. Вы также можете запустить его вручную, открыв браузер и перейдя по адресу http://localhost:<PORT>. Проверьте вывод команды, чтобы узнать локальный порт, на котором запущен MCP Inspector. В этом примере MCP Inspector работает на порту 5173.

2. В MCP inspector введите URL вашего MCP-сервера (например, http://localhost:8788/mcp). Выберите Подключить.

   Вы можете подключиться к MCP-серверу, работающему на вашем локальном компьютере, или к удалённому MCP-серверу, работающему на Cloudflare.

3. Если ваш сервер требует аутентификации, подключение завершится ошибкой. Чтобы пройти аутентификацию:

   1. В MCP Inspector выберите Открыть настройки Auth.
   2. Выберите Быстрый OAuth-процесс.
   3. После аутентификации через OAuth-провайдера вы будете перенаправлены обратно в MCP Inspector. Выберите Подключить.

Вы должны увидеть Список инструментов кнопку, которая покажет список инструментов, предоставляемых вашим MCP-сервером.

Перейдите в Workers AI Playground ↗, введите URL своего сервера MCP и нажмите "Connect". После аутентификации (если она требуется) вы должны увидеть список своих инструментов, и они станут доступны модели ИИ в чате.

Вы можете использовать mcp-remote локальный прокси ↗ чтобы подключить Claude Desktop к вашему удалённому MCP-серверу. Это позволяет протестировать, как будет выглядеть взаимодействие с вашим удалённым MCP-сервером через реальный MCP-клиент.

1. Откройте Claude Desktop и перейдите в Settings -> Developer -> Edit Config. Это откроет конфигурационный файл, который определяет, к каким MCP-серверам имеет доступ Claude.
2. Замените содержимое на такую конфигурацию:

{
	"mcpServers": {
		"my-server": {
			"command": "npx",
			"args": ["mcp-remote", "http://my-mcp-server.my-account.workers.dev/mcp"]
		}
	}
}

3. Сохраните файл и перезапустите Claude Desktop (command/ctrl + R). После перезапуска Claude откроется окно браузера со страницей входа OAuth. Завершите процесс авторизации, чтобы предоставить Claude доступ к вашему MCP-серверу.

После аутентификации вы сможете увидеть свои инструменты, нажав на значок инструментов в правом нижнем углу интерфейса Claude.

Подключите Cursor ↗ к вашему удалённому MCP-серверу, отредактировав файл проекта .cursor/mcp.json файл или глобальный ~/.cursor/mcp.json файл и добавьте следующую конфигурацию:

{
	"mcpServers": {
		"my-server": {
			"url": "http://my-mcp-server.my-account.workers.dev/mcp"
		}
	}
}

Вы можете подключить свой удалённый MCP-сервер к Windsurf ↗ путём редактирования mcp_config.json файл ↗, и добавив следующую конфигурацию:

{
	"mcpServers": {
		"my-server": {
			"serverUrl": "http://my-mcp-server.my-account.workers.dev/mcp"
		}
	}
}