Waafir
Эта страница переведена машинным способом и ожидает проверки человеком. Возможны неточности.

Настройка

Чтобы подключить ИИ-помощника к Waafir, нужен один URL: вставьте его в помощника, а затем войдите в Waafir, когда он попросит. Создавать или копировать токен не нужно. На этой странице описаны вход в систему, шаг добавления сервера для каждого помощника и подключение с помощью личного токена доступа, если помощник не может выполнить вход.

Основы

URL. Один URL обслуживает все инструменты Waafir:

https://app.waafir.io/api/mcp/waafir

Раздел Дополнения → Конфигурация → AI-помощники показывает URL для вашего развёртывания с кнопкой копирования. Замените https://app.waafir.io, если вы работаете в другом развёртывании.

Вход в систему. Когда помощник впервые использует URL, он открывает Waafir в вашем браузере. Войдите как обычно, затем просмотрите экран согласия:

  • В какой организации работает помощник, если вы состоите более чем в одной;
  • К каким комнатам данных он может получить доступ: ко всем или только к выбранным вами;
  • Что ему разрешено: чтение, запись или администрирование — никогда больше, чем позволяет ваша собственная роль, — а также может ли он подписывать документы или отправлять за пределы вашей организации;
  • Подтвердите, что это вы. Если вы настроили двухфакторную аутентификацию, каждое одобрение сначала запрашивает ваш код — так же, как при создании токена.

Одобрите, и браузер вернёт вас к помощнику. Подключение появится в разделе Дополнения → Конфигурация → AI-помощники, где можно увидеть, к чему оно имеет доступ, и отозвать его. См. Подключения.

Unverified app "…". Помощник, который идентифицирует себя веб-адресом под своим контролем, отображается по этому адресу, например claude.ai. Помощник, который зарегистрировал себя сам под выбранным им именем, отображается как Unverified app "<its name>": Waafir не может подтвердить, кто его создал, поэтому одобряйте его, только если вы сами начали подключение.

Что показывает список инструментов. Имена инструментов начинаются с их области: dataroom_, esign_, redact_ и translate_. В списке есть только инструменты, которые может использовать ваше подключение и ваша организация: подключению только для чтения не показываются инструменты записи, а инструменты электронной подписи появляются, только если у вашей организации есть дополнение E-Signatures или активная подписка. Подключение также показывает инструменты, которым нужно разрешение, которое вы не предоставили, например подписание или отправка за пределы вашей организации. Если помощник вызывает такой инструмент, Waafir отклоняет вызов, и помощник просит вас снова дать одобрение — на этот раз с предложением этого разрешения. Токен не может запросить повторно, поэтому в его списке таких инструментов нет. Инструмент, которого нет в списке, всё равно отклоняется с указанием причины, если помощник его всё-таки вызовет.

Подключение помощника

В каждом разделе ниже приведён шаг добавления сервера для конкретного помощника и ссылка на его документацию (каждая ссылка последний раз проверена 23 октября 2026 года). Ни один из этих помощников ещё не был протестирован со входом в Waafir, поэтому в каждом разделе рядом сохранён резервный вариант с токеном.

Claude (claude.ai и Claude Desktop)

Ещё не протестировано Waafir. Откройте Customize → Connectors, выберите Add → Add custom connector, задайте имя, вставьте URL и продолжите. Оставьте вход включённым и войдите в Waafir, когда Claude попросит. Чтобы использовать коннектор в чате, включите его в + → Connectors. В тарифах Team или Enterprise коннекторы добавляет владелец в разделе Organization settings → Connectors. (руководство Claude)

Если вход не работает, добавьте заголовок запроса Authorization: Bearer <token> с токеном (см. Подключение с помощью токена).

ChatGPT

Ещё не протестировано Waafir. ChatGPT обращается к удалённым MCP-серверам в разных местах в зависимости от приложения; в настольном приложении откройте Settings → MCP servers → Add server и вставьте URL, затем войдите в Waafir, когда появится запрос. (руководство OpenAI)

Если ChatGPT не может выполнить вход, используйте вместо этого токен.

Claude Code

Ещё не протестировано Waafir.

claude mcp add --transport http waafir https://app.waafir.io/api/mcp/waafir

Затем выполните /mcp внутри Claude Code (или claude mcp login waafir из командной оболочки) и войдите в Waafir в браузере. Добавьте --scope user, чтобы использовать сервер во всех проектах. В разделе Дополнения → Конфигурация → AI-помощники эта команда готова к копированию. (руководство Claude Code)

Cursor

Ещё не протестировано Waafir. Добавьте URL в .cursor/mcp.json (или в ~/.cursor/mcp.json для всех проектов), затем войдите в Waafir, когда Cursor попросит:

{
  "mcpServers": {
    "waafir": {
      "url": "https://app.waafir.io/api/mcp/waafir"
    }
  }
}

(руководство Cursor)

Если Cursor не может выполнить вход, добавьте заголовок с токеном, как показано в разделе Подключение с помощью токена.

VS Code

Ещё не протестировано Waafir. Выполните MCP: Add Server из палитры команд (Command Palette), выберите HTTP, вставьте URL и задайте идентификатор waafir. Войдите в Waafir, когда VS Code попросит. (руководство VS Code)

Gemini CLI

Ещё не протестировано Waafir.

gemini mcp add --transport http waafir https://app.waafir.io/api/mcp/waafir

Затем выполните /mcp auth waafir и войдите в браузере. Для входа нужен локальный браузер, поэтому в большинстве удалённых SSH-сеансов он не работает: используйте там токен. (руководство Gemini CLI)

Codex

Ещё не протестировано Waafir.

codex mcp add waafir --url https://app.waafir.io/api/mcp/waafir
codex mcp login waafir

(руководство Codex)

Подключение с помощью токена

Используйте личный токен доступа, если помощник не может выполнить вход, или для скрипта. Каждый запрос передаёт токен как токен носителя (bearer token) в заголовке Authorization:

Authorization: Bearer waafir_pat_...

Никогда не фиксируйте настоящий токен в общем файле или репозитории; обращайтесь с ним как с паролем. В разделе Дополнения → Конфигурация → API-токены есть готовый к копированию фрагмент.

Серверы областей. Помимо waafir, по-прежнему обслуживаются четыре сервера областей, поэтому существующая конфигурация продолжает работать. Каждый из них показывает только инструменты своей области, отфильтрованные тем же образом, и сохраняет прежние имена инструментов (list_files, а не dataroom_list_files). Если вы подключаетесь к waafir, они вам не нужны:

СерверURL
waafir-redacthttps://app.waafir.io/api/mcp/waafir-redact
waafir-translatehttps://app.waafir.io/api/mcp/waafir-translate
waafir-dataroomhttps://app.waafir.io/api/mcp/waafir-dataroom
waafir-esignhttps://app.waafir.io/api/mcp/waafir-esign

Конечной точки /api/mcp без имени сервера нет: сегмент с именем сервера обязателен, и запрос без него возвращает 404. waafir-esign — это платная услуга: без дополнения E-Signatures или активной подписки его URL отвечает ошибкой ADDON_NOT_PURCHASED. На waafir та же организация просто не видит инструментов esign_.

Claude Code. Сначала поместите токен в переменную окружения, чтобы он не попал в историю командной оболочки:

export WAAFIR_PAT=...   # the token you copied at issuance
claude mcp add --transport http waafir https://app.waafir.io/api/mcp/waafir \
  --header "Authorization: Bearer $WAAFIR_PAT"

Чтобы поделиться настройкой с проектом, поместите ту же запись в его .mcp.json. Claude Code подставляет ${WAAFIR_PAT} из окружения каждого человека, поэтому файл можно зафиксировать в репозитории без токена:

{
  "mcpServers": {
    "waafir": {
      "type": "http",
      "url": "https://app.waafir.io/api/mcp/waafir",
      "headers": {
        "Authorization": "Bearer ${WAAFIR_PAT}"
      }
    }
  }
}

Файл конфигурации Claude Desktop. claude_desktop_config.json запускает локальные серверы: каждая запись — это command для запуска, а не удалённый url. Чтобы обращаться к Waafir из этого файла, запустите мост mcp-remote (ему нужен Node.js), который перенаправляет запросы на удалённый сервер и добавляет ваш токен в заголовок:

{
  "mcpServers": {
    "waafir": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.waafir.io/api/mcp/waafir",
        "--header",
        "Authorization:${WAAFIR_AUTH}"
      ],
      "env": {
        "WAAFIR_AUTH": "Bearer YOUR_WAAFIR_PAT"
      }
    }
  }
}

Аргумент Authorization:${WAAFIR_AUTH} не должен содержать пробелов; затем перезапустите Claude Desktop.

Cursor и другие клиенты, принимающие URL и заголовки.

{
  "mcpServers": {
    "waafir": {
      "url": "https://app.waafir.io/api/mcp/waafir",
      "headers": {
        "Authorization": "Bearer YOUR_WAAFIR_PAT"
      }
    }
  }
}

Сервер области добавляется так же — с изменением ключа записи и URL.

Вызов инструмента

После подключения клиент получает список инструментов сервера (MCP-запрос tools/list) и вызывает их от вашего имени. Вы не вызываете инструменты вручную — вы просите ИИ-клиента что-то сделать («покажи файлы в этой комнате данных», «переведи этот абзац на французский»), и он выбирает и вызывает нужный инструмент, передавая аргументы, описанные в справочнике каждого сервера. Контракты инструментов см. в справочниках waafir-redact, waafir-translate, waafir-dataroom и waafir-esign.

Когда что-то идёт не так

Сбои приходят на двух разных уровнях, и выглядят они по-разному. Путаница здесь — самая частая ошибка интеграции: клиент, который ветвится только по HTTP-статусу, молча пропустит каждый сбой второго типа.

Уровень 1 — запрос отклонён до запуска какого-либо инструмента

Это настоящие HTTP-статусы ошибок с телом ошибки в формате JSON-RPC. Они означают, что запрос вообще не дошёл до инструмента:

  • 404 — Неизвестный MCP-сервер. Сегмент имени сервера в URL не является одним из waafir, waafir-redact, waafir-translate, waafir-dataroom или waafir-esign — чаще всего это опечатка или голый /api/mcp без имени сервера. Исправьте URL.

  • 402 — Дополнение не приобретено. Сервер является платной услугой (на сегодня — waafir-esign), а у вашей организации нет ни дополнения, ни активной подписки. Администратор организации может приобрести дополнение или тариф в настройках биллинга. Организация без соответствующего права не может даже получить список инструментов сервера. waafir никогда не отвечает 402: вместо этого он скрывает платные инструменты, а вызов одного из них отклоняется на уровне 2 с QUOTA_EXCEEDED и сообщением, называющим этот инструмент, которое также содержит ADDON_NOT_PURCHASED.

  • 401 — Не аутентифицирован. Учётные данные отсутствуют, имеют неверный формат, отозваны или истекли. Для подключения снова войдите в систему из помощника: большинство помощников делают это сами, получив 401, а подключению, которое было отозвано или не использовалось 30 дней, нужен новый вход. Для токена проверьте, что заголовок Authorization присутствует и что токен по-прежнему активен в разделе Дополнения → Конфигурация → API-токены; выпустите новый, если он был отозван или истёк. Развёртывание, предшествующее этому поведению, на отсутствующий или неверно сформированный токен отвечает вместо этого 403 CSRF validation failed: missing Origin; на этой поверхности это тоже означает, что токен отсутствует или имеет неверный формат.

  • 403 — Запрещено. Учётные данные отклонены на входе: вместо подключения или PAT был использован сеанс браузера с выполненным входом (сеансы на этой поверхности не принимаются), либо ваша организация применяет список разрешённых IP-адресов, а запрос пришёл с адреса вне его.

  • 429 — Слишком много запросов. Вы достигли лимита частоты запросов MCP. Здесь ничего не привязано к вашему IP-адресу или к вашей организации — ваш бюджет принадлежит вашему токену, поэтому коллега в той же организации и второй клиент в той же сети его не расходуют. Лимит — 60 запросов в минуту на токен. Он подсчитывается до поиска токена, поэтому неверно сформированный, отозванный или истёкший токен тоже его расходует, а вызовы того же токена к API Waafir вне MCP учитываются в тех же 60. Для подключения, созданного при входе, эти 60 также подсчитываются на подключение, поэтому новый токен, который помощник получает при обновлении входа, не начинает новый отсчёт 60.

    Ответ не содержит заголовка Retry-After и отличительного кода — любой 429 на этой поверхности выглядит одинаково, — поэтому делайте паузы по собственному расписанию, а не повторяйте запросы в цикле. Если одному токену не хватает запаса, выпустите второй: лимит действует на токен.

Уровень 2 — инструмент запустился и отказал

Именно здесь возникает большинство отказов, и это не HTTP-ошибка. HTTP-ответ — 200, а конверт JSON-RPC — успешный. Сбой передаётся внутри результата инструмента, в котором установлено isError: true, а текстовое содержимое таково:

{ "error": { "code": "CONFLICT", "message": "…" } }

Ветвитесь по error.code. Коды такие:

КодЗначение
INVALID_ARGUMENTАргумент отсутствует, имеет неверный формат или не является действительным идентификатором — исправьте и повторите
FORBIDDENТокен действителен, но для этого вызова у него нет разрешения
NOT_FOUNDТакой записи нет, или она не ваша
CONFLICTЗапрос понят и разрешён, но комната данных не в том состоянии, в котором его можно выполнить
TOO_LARGEВходные данные превышают ограничение по размеру — разделите их
QUOTA_EXCEEDEDТарифицируемый лимит исчерпан; кому-то нужно что-то купить или повысить тариф
UPSTREAM_ERROR / UNAVAILABLEВременный сбой нижележащего сервиса — повторите позже
INTERNALНепредвиденный сбой — не повторяйте, передайте на эскалацию

Два из них часто сбивают с толку:

  • FORBIDDEN при слишком низкой области доступа. Подключению или токену read не показываются инструменты записи, но клиент, который всё-таки вызывает один из них, получает отказ от инструмента, поэтому он приходит сюда как FORBIDDEN в полезной нагрузке — а не как HTTP 403. То же относится к токену, ограниченному конкретными комнатами данных, который указывает в dataroom_id комнату вне своего списка разрешённых. Большинство инструментов, принимающих идентификатор файла или папки, вместо этого отвечают NOT_FOUND для элемента в такой комнате — точно так же, как для несуществующего идентификатора. Снова войдите в систему из помощника и предоставьте нужную область доступа или комнаты данных либо выпустите токен с нужной областью доступа.
  • CONFLICT. Вызов понят и разрешён, но комната данных не в том состоянии, в котором его можно выполнить, — имя папки уже занято, имя файла с тех пор занял действующий файл, или восстановление, контейнер которого всё ещё удалён или загрузка которого так и не завершилась. CONFLICT — не проблема авторизации, и повторный вход или перевыпуск токена не помогут; сообщение называет блокирующую запись, если она есть, чтобы вы могли с ней разобраться и повторить. В справочнике waafir-dataroom перечислены конфликты, которые может вернуть каждый инструмент.

Файл, который ещё проверяется. Waafir проверяет каждый только что загруженный файл и каждую новую версию, прежде чем выдавать их содержимое. До тех пор инструмент, читающий содержимое файла, отвечает UNAVAILABLE с error.reason: "ACTIVATION_PENDING" и сообщением This file is still being checked. Try again shortly. Это временно: вызовите инструмент снова после короткой паузы.

Явный отказ на любом из уровней — ожидаемый и безопасный исход вызова, который Waafir не станет обслуживать: запрос завершается сбоем, а не молча делает меньше, чем вы просили.