IBM watsonx.ai Granite — MCP-сервер для Claude Code: установка и обзор
Подключает модели IBM Granite из вашего аккаунта watsonx.ai к агенту: чат, генерация, эмбеддинги, подсчёт токенов и прогноз временных рядов.
claude mcp add --env WATSONX_API_KEY=<WATSONX_API_KEY> --env WATSONX_PROJECT_ID=<WATSONX_PROJECT_ID> --env WATSONX_SPACE_ID=<WATSONX_SPACE_ID> --env WATSONX_URL=<WATSONX_URL> --env WATSONX_MODEL_ID=<WATSONX_MODEL_ID> --transport stdio ibm-watsonx-mcp -- npx -y @three-ws/ibm-watsonx-mcpЧто делает IBM watsonx.ai Granite
Сервер ходит в REST API watsonx.ai напрямую, с вашими учётными данными IBM Cloud. Ключ WATSONX_API_KEY меняется на короткоживущий IAM-токен, тот кешируется в процессе и обновляется незадолго до истечения. Промежуточного бэкенда нет.
Внутри шесть инструментов: watsonx_chat, watsonx_generate, watsonx_embed, watsonx_tokenize, watsonx_forecast и watsonx_list_models. Все они только вызывают модели, ничего в аккаунте не меняют, и помечены аннотациями readOnlyHint, openWorldHint, idempotentHint.
Нужен Node.js версии 20 или новее, аккаунт IBM Cloud с подключённым watsonx.ai, API-ключ и id проекта. Проект сообщества, к IBM отношения не имеет. Ключ и id проекта передаются переменными окружения, без них сервер не стартует.
Какие задачи решает
- прогнать запрос к Granite прямо из агента
- получить эмбеддинги для списка текстов
- посчитать токены до отправки промпта
- построить прогноз по временному ряду
- посмотреть, какие модели доступны в регионе
Примеры запросов агенту
- Спроси у
watsonx_chat, что такое MCP, одним предложением - Сделай эмбеддинги для строк «lakehouse» и «data warehouse» через
watsonx_embed - Покажи через
watsonx_list_modelsтолько модели для эмбеддингов
Как установить IBM watsonx.ai Granite
Командой платформы
claude mcp add --env WATSONX_API_KEY=<WATSONX_API_KEY> --env WATSONX_PROJECT_ID=<WATSONX_PROJECT_ID> --env WATSONX_SPACE_ID=<WATSONX_SPACE_ID> --env WATSONX_URL=<WATSONX_URL> --env WATSONX_MODEL_ID=<WATSONX_MODEL_ID> --transport stdio ibm-watsonx-mcp -- npx -y @three-ws/ibm-watsonx-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add ibm-watsonx-mcp --env WATSONX_API_KEY=<WATSONX_API_KEY> --env WATSONX_PROJECT_ID=<WATSONX_PROJECT_ID> --env WATSONX_SPACE_ID=<WATSONX_SPACE_ID> --env WATSONX_URL=<WATSONX_URL> --env WATSONX_MODEL_ID=<WATSONX_MODEL_ID> -- npx -y @three-ws/ibm-watsonx-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"ibm-watsonx-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/ibm-watsonx-mcp"
],
"env": {
"WATSONX_API_KEY": "<WATSONX_API_KEY>",
"WATSONX_PROJECT_ID": "<WATSONX_PROJECT_ID>",
"WATSONX_SPACE_ID": "<WATSONX_SPACE_ID>",
"WATSONX_URL": "<WATSONX_URL>",
"WATSONX_MODEL_ID": "<WATSONX_MODEL_ID>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"ibm-watsonx-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/ibm-watsonx-mcp"
],
"env": {
"WATSONX_API_KEY": "<WATSONX_API_KEY>",
"WATSONX_PROJECT_ID": "<WATSONX_PROJECT_ID>",
"WATSONX_SPACE_ID": "<WATSONX_SPACE_ID>",
"WATSONX_URL": "<WATSONX_URL>",
"WATSONX_MODEL_ID": "<WATSONX_MODEL_ID>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e WATSONX_API_KEY=<WATSONX_API_KEY> -e WATSONX_PROJECT_ID=<WATSONX_PROJECT_ID> -e WATSONX_SPACE_ID=<WATSONX_SPACE_ID> -e WATSONX_URL=<WATSONX_URL> -e WATSONX_MODEL_ID=<WATSONX_MODEL_ID> ibm-watsonx-mcp npx -y @three-ws/ibm-watsonx-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о IBM watsonx.ai Granite
Как установить IBM watsonx.ai Granite в Claude Code?
Одной командой: claude mcp add ibm-watsonx -e WATSONX_API_KEY=<WATSONX_API_KEY> -- npx -y @three-ws/ibm-watsonx-mcp. Ключ WATSONX_API_KEY подставьте свой.
Что делает IBM watsonx.ai Granite?
Даёт агенту доступ к моделям из вашего проекта watsonx.ai: чат, генерация текста, эмбеддинги, токенизация, прогноз и список моделей.
Что нужно для работы сервера?
Node.js 20 или новее, аккаунт IBM Cloud с watsonx.ai, API-ключ IBM Cloud и id проекта. Последние два передаются через WATSONX_API_KEY и WATSONX_PROJECT_ID.
