businessmcp — MCP-сервер для Claude Code: функции и установка
Набор средств для MCP-шлюза: проверяет адреса перед запросом к серверам, разбирает ошибки и предотвращает совпадения имён инструментов.
claude mcp add --transport http businessmcp https://businessmcp.com/api/mcpЧто делает businessmcp
В шлюзе пользователь может указать адрес стороннего MCP-сервера, который затем запрашивается с инфраструктуры шлюза. isPublicHttpUrl проверяет, что адрес ведёт на публичные IP, а isBlockedIp распознаёт в том числе IPv4-адреса, встроенные в IPv6. Проверка DNS не закрывает окно между разрешением адреса и подключением. Перенаправления нужно проходить вручную и проверять каждый переход.
classifyUpstreamError различает ошибки авторизации, транспорта, тайм-аута, заблокированного хоста и недоступности; describeFailure формирует сообщение для пользователя. namespacedToolName добавляет пространству имён инструмента префикс, а при усечении имени — короткий хеш. withUpstream пробует Streamable HTTP, затем SSE, и сообщает, какой транспорт сработал. Для этой функции нужна зависимость @modelcontextprotocol/client; остальные модули обходятся без неё.
Это утилиты, а не готовый шлюз: агрегации серверов, авторизации и слоя политик здесь нет. DNS-проверка оставляет риск подмены адреса между проверкой и подключением.
Какие задачи решает
- проверить URL MCP-сервера перед запросом
- распознать причину сбоя upstream-сервера
- дать пользователю объяснение ошибки подключения
- развести имена инструментов из разных серверов
- подобрать транспорт для upstream-сервера
Примеры запросов агенту
- Проверь, ведёт ли адрес MCP-сервера на публичный IP.
- Разбери ошибку подключения к upstream и объясни её пользователю.
- Создай разные имена для инструментов из двух MCP-серверов.
Как установить businessmcp
Командой платформы: удалённый сервер
claude mcp add --transport http businessmcp https://businessmcp.com/api/mcpКомандой платформы: удалённый сервер
codex mcp add businessmcp --url https://businessmcp.com/api/mcpФайл настроек
{
"mcpServers": {
"businessmcp": {
"url": "https://businessmcp.com/api/mcp"
}
}
}Файл настроек
{
"servers": {
"businessmcp": {
"type": "http",
"url": "https://businessmcp.com/api/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http businessmcp https://businessmcp.com/api/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о businessmcp
Как установить businessmcp в Claude Code?
Выполните claude mcp add --transport http businessmcp https://businessmcp.com/api/mcp.
Что делает businessmcp?
Набор утилит помогает защитить MCP-шлюз при обращении к сторонним серверам: проверяет адреса, классифицирует сбои, задаёт имена инструментам и пробует транспортные варианты.
Нужен ли @modelcontextprotocol/client?
Да, если используете withUpstream. Остальным модулям эта зависимость не нужна.
