ictfax-mcp — MCP-сервер для Claude Code: установка
Подключает Claude Code к ICTFax через ICTCore REST: агент смотрит факсы и их статусы, а при включённой записи отправляет документы.
claude mcp add --env ICTFAX_BASE_URL=<ICTFAX_BASE_URL> --env ICTFAX_USERNAME=<ICTFAX_USERNAME> --env ICTFAX_PASSWORD=<ICTFAX_PASSWORD> --env ICTFAX_ACCOUNT_ID=<ICTFAX_ACCOUNT_ID> --env ICTFAX_MCP_ALLOW_WRITE=<ICTFAX_MCP_ALLOW_WRITE> --transport stdio ictfax-mcp -- npx -y ictfax-mcpЧто делает ictfax-mcp
ictfax-mcp даёт агенту два инструмента для чтения: список факсов с контактами, статусами и направлением, а также проверку статуса передачи по идентификатору. Подключение идёт к ICTCore REST с JWT-аутентификацией через ICTFAX_BASE_URL, ICTFAX_USERNAME и ICTFAX_PASSWORD.
Отправка устроена как цепочка загрузки PDF, создания получателя и передачи факса. Инструменты записи появляются только при ICTFAX_MCP_ALLOW_WRITE=true: отправка звонит на реальный номер и может стоить денег. Для запуска нужен Node.js 18 или новее; без адреса API и учётных данных сервер не подключится.
Какие задачи решает
- получить список факсов из ICTFax
- проверить статус передачи по идентификатору
- загрузить локальный PDF как документ факса
- отправить документ на номер получателя
Примеры запросов агенту
- Покажи список факсов в ICTFax и их текущие статусы.
- Проверь статус передачи факса с идентификатором
<id>. - Загрузи локальный PDF и отправь его факсом на номер получателя.
Как установить ictfax-mcp
Командой платформы
claude mcp add --env ICTFAX_BASE_URL=<ICTFAX_BASE_URL> --env ICTFAX_USERNAME=<ICTFAX_USERNAME> --env ICTFAX_PASSWORD=<ICTFAX_PASSWORD> --env ICTFAX_ACCOUNT_ID=<ICTFAX_ACCOUNT_ID> --env ICTFAX_MCP_ALLOW_WRITE=<ICTFAX_MCP_ALLOW_WRITE> --transport stdio ictfax-mcp -- npx -y ictfax-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add ictfax-mcp --env ICTFAX_BASE_URL=<ICTFAX_BASE_URL> --env ICTFAX_USERNAME=<ICTFAX_USERNAME> --env ICTFAX_PASSWORD=<ICTFAX_PASSWORD> --env ICTFAX_ACCOUNT_ID=<ICTFAX_ACCOUNT_ID> --env ICTFAX_MCP_ALLOW_WRITE=<ICTFAX_MCP_ALLOW_WRITE> -- npx -y ictfax-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"ictfax-mcp": {
"command": "npx",
"args": [
"-y",
"ictfax-mcp"
],
"env": {
"ICTFAX_BASE_URL": "<ICTFAX_BASE_URL>",
"ICTFAX_USERNAME": "<ICTFAX_USERNAME>",
"ICTFAX_PASSWORD": "<ICTFAX_PASSWORD>",
"ICTFAX_ACCOUNT_ID": "<ICTFAX_ACCOUNT_ID>",
"ICTFAX_MCP_ALLOW_WRITE": "<ICTFAX_MCP_ALLOW_WRITE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"ictfax-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ictfax-mcp"
],
"env": {
"ICTFAX_BASE_URL": "<ICTFAX_BASE_URL>",
"ICTFAX_USERNAME": "<ICTFAX_USERNAME>",
"ICTFAX_PASSWORD": "<ICTFAX_PASSWORD>",
"ICTFAX_ACCOUNT_ID": "<ICTFAX_ACCOUNT_ID>",
"ICTFAX_MCP_ALLOW_WRITE": "<ICTFAX_MCP_ALLOW_WRITE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e ICTFAX_BASE_URL=<ICTFAX_BASE_URL> -e ICTFAX_USERNAME=<ICTFAX_USERNAME> -e ICTFAX_PASSWORD=<ICTFAX_PASSWORD> -e ICTFAX_ACCOUNT_ID=<ICTFAX_ACCOUNT_ID> -e ICTFAX_MCP_ALLOW_WRITE=<ICTFAX_MCP_ALLOW_WRITE> ictfax-mcp npx -y ictfax-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ictfax-mcp
Как установить ictfax-mcp в Claude Code?
Выполните `claude mcp add ictfax-mcp -e ICTFAX_BASE_URL=<ICTFAX_BASE_URL> -e ICTFAX_USERNAME=<ICTFAX_USERNAME> -e ICTFAX_PASSWORD=<ICTFAX_PASSWORD> -- npx -y ictfax-mcp`.
Что делает ictfax-mcp?
Сервер подключает агента к ICTFax через ICTCore REST. Он показывает передачи факсов и их статусы, а после включения записи загружает документы и отправляет факсы.
Можно ли отправлять факсы сразу после установки?
Нет. Инструменты записи регистрируются только при ICTFAX_MCP_ALLOW_WRITE=true. Отправка обращается к реальному номеру и может повлечь расходы.
