Подключение MCP-клиента¶

Результат¶

Вы подключите AI-клиент к одному проекту Threadory и сможете использовать знания проекта, не копируя токен в чат или документацию.

Что потребуется¶

У вас должна быть project role; read-only MCP доступен viewer и всем более высоким ролям.
Клиент должен поддерживать удалённый MCP по Streamable HTTP.
Для интерактивного клиента используйте OAuth в браузере. Headless- или CI-клиенту потребуется project API key, созданный администратором.

Каждый проект подключается как отдельный MCP server. URL содержит адрес, уникальный для этого проекта, поэтому не используйте адрес из другого проекта.

Адрес — сгенерированная строка вида p-7m3k9q2xvz, а не название проекта. Имя хоста уходит в сеть незашифрованным при каждом подключении, поэтому оно намеренно ничего не сообщает ни о вас, ни о вашей работе. Адрес не меняется: однажды добавленный коннектор продолжает работать, в том числе после переименования проекта. Адрес показан рядом с Connection URL в Settings → MCP.

Общий адрес¶

У Threadory есть и один общий адрес для всех: https://mcp.threadory.ai/mcp. Войдите своей учётной записью Threadory — подключение привяжется к проекту, который Threadory выбирает для вас. По умолчанию это проект, где у вас самая высокая роль, а при равенстве выигрывает более раннее членство; приоритет имеют проект по умолчанию, закреплённый в вашем развёртывании, и проект, который вы выбрали на прежней версии экрана входа. Такого экрана сейчас нет. Если проект у вас один, это он. Авторизация не меняется: каждый вызов проверяется по вашему текущему членству и роли, и доступа к чужому проекту этот адрес не даёт.

Чтобы точно знать, в какой проект попадает клиент, когда вы состоите в нескольких, используйте собственный адрес этого проекта из Settings → MCP (описан выше). Добавляйте по одному подключению на проект.

Выберите способ под свой клиент:

Claude Code. Выполните команду, затем введите /mcp в Claude Code и пройдите вход в браузере:

claude mcp add --transport http threadory https://mcp.threadory.ai/mcp

Cursor. Откройте ссылку в браузере или вставьте в адресную строку и проверьте запись, которую покажет Cursor:

cursor://anysphere.cursor-deeplink/mcp/install?name=threadory&config=eyJ1cmwiOiJodHRwczovL21jcC50aHJlYWRvcnkuYWkvbWNwIn0=

VS Code. Откройте ссылку так же:

vscode:mcp/install?%7B%22name%22%3A%22threadory%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.threadory.ai%2Fmcp%22%7D

Любой другой клиент. Добавьте это в его MCP-конфигурацию или вставьте адрес в диалог удалённого сервера:

{
  "mcpServers": {
    "threadory": {
      "url": "https://mcp.threadory.ai/mcp"
    }
  }
}

Те же кнопки и список инструментов сервера есть на публичной странице https://threadory.ai/mcp. Ссылка установки открывает клиент с готовой записью; войти всё равно нужно после этого.

Подключить Claude через OAuth¶

Выберите нужный проект в Threadory.
Откройте Settings → MCP.
В блоке Connection URL нажмите Copy.
В Claude откройте Settings → Connectors → Add custom connector.
Вставьте URL и продолжите настройку.
По запросу выполните вход в браузере.
Вернитесь в Claude и попросите найти или посчитать несекретные сущности проекта.

Блок One-click install может сразу открыть настройки connector в Claude, но не отменяет OAuth-вход.

Подключить Cursor или VS Code¶

Откройте Settings → MCP нужного проекта.
В One-click install нажмите кнопку Cursor или VS Code.
До подтверждения проверьте созданную клиентом запись server.
Если клиент запросит, завершите аутентификацию в браузере.
Если tools не появились сразу, начните новую сессию клиента.

Настроить другой клиент¶

Убедитесь, что клиент поддерживает удалённые HTTP MCP servers.
Скопируйте Manual config (mcp.json) из Settings → MCP.
Вставьте конфигурацию в настройки MCP-клиента.
Сохраняйте сгенерированное имя server вместе с URL проекта.
Пройдите аутентификацию и начните с read-only запроса.

Показанный JSON подходит клиентам с конфигурацией mcpServers, включая Claude Code, Cursor и Windsurf. Путь к файлу и способ перезагрузки зависят от клиента; последний шаг сверяйте с его документацией.

Headless-клиенты и API keys¶

Попросите администратора открыть Settings → API Keys.
Создайте key с именем, указывающим владельца и назначение.
Сразу скопируйте plaintext: значение показывается только один раз.
Сохраните его в secret store клиента или protected CI variable.
Передавайте его как bearer credential. Не добавляйте key в URL, Git, скриншоты, логи или prompts.
Отзовите key после вывода клиента из эксплуатации или при подозрении на утечку.

OAuth-доступ следует роли пользователя в проекте. Чтение через MCP доступно участникам проекта; write-tools дополнительно ограничены фактической ролью и scopes credential. Server также проверяет, что credential соответствует выбранному проекту.

Как проверить результат¶

Клиент показывает knowledge tools Threadory без ошибки аутентификации.
Простой read-запрос возвращает данные только выбранного проекта.
Tool для cited answer возвращает источники, которые можно открыть в Threadory.
Credential роли viewer не может изменять граф.

Частые проблемы¶

Симптом	Вероятная причина	Что сделать
`401` или цикл входа	OAuth не завершён, истёк или клиент сохранил старую сессию	Удалите подключение, добавьте его снова с актуальным URL и завершите вход
`403`	Вы не участник проекта из URL или tool недоступен вашей роли	Проверьте проект и попросите администратора проверить membership
Tools двух проектов конфликтуют	Один connection был использован повторно	Создайте отдельно названный connection для каждого проекта
Клиент не принимает конфигурацию	Нет поддержки remote Streamable HTTP или используется другая схема	Следуйте инструкции клиента для remote MCP; не превращайте URL в локальную команду
API key перестал работать	Key отозван или скопирован с ошибкой	Создайте замену: восстановить plaintext в Threadory нельзя
Write-tool запрещён	Credential read-only или не имеет нужного scope	Оставьте read-only, если его достаточно; расширение согласуйте с администратором

Следующий шаг¶

Используйте поиск и ответы с источниками в web UI или проверьте права ролей.