Перейти к содержимому

MCP: подключение агента

MCP (Model Context Protocol) это способ дать ИИ-агенту доступ к вашим проектам и оценкам в Dead Point. Агент (Claude Code, Cursor, Codex CLI или Gemini CLI) читает оценки, а с правом записи собирает черновики, публикует версии и создаёт ссылки для клиента. Доступ даёт токен: он работает как пароль, поэтому храните его так же и выпускайте отдельный токен на каждого агента. Пользоваться можно бесплатно: 100 вызовов в месяц на воркспейс и 60 вызовов в минуту на токен.

  1. Откройте "Аккаунт", вкладку "MCP".
  2. Введите название токена, например "Claude Code на ноутбуке".
  3. Выберите доступ, нажмите "Выпустить токен".
  4. Скопируйте токен. Показываем токен один раз: потом посмотреть его не получится.

Токен хранится как пароль. Выпустите отдельный токен на каждого агента, так его проще отозвать.

ДоступЧто может агент
Только чтениеВидит проекты и оценки
Чтение и черновики оценокЕщё создаёт черновики оценок, правит или удаляет позиции в черновиках, созданных через MCP от вашего имени, публикует версии любой оценки воркспейса и создаёт ссылки для клиента, если у вас есть право править оценки проекта (КП клиенту через агента)

Запись выбирайте только для клиента, которому доверяете. Запрос на запись с токеном только для чтения получает отказ.

После выпуска токена окно "Токен выпущен" ведёт по четырём шагам: сохранить токен, подключить агента, проверить связь, дать первое задание. Ниже тот же второй шаг по каждому агенту. Токен в строках уже подставлен окном, здесь он показан как <токен>. Адрес сервера на снимках условный: берите строку из своего окна.

Откройте Терминал и вставьте команду. Сервер добавится в настройки Claude Code, перезапуск не нужен.

Окно терминала
claude mcp add --transport http deadpoint https://api.deadpoint.app/mcp --header "Authorization: Bearer <токен>"
Окно Токен выпущен, шаг Подключите агента: выбран Claude Code, над командой подсказка открыть Терминал, справа от команды кнопка Копировать

Добавьте блок в файл ~/.cursor/mcp.json. Если в файле уже есть mcpServers, добавьте в него только запись deadpoint. Перезапустите Cursor.

{
"mcpServers": {
"deadpoint": {
"url": "https://api.deadpoint.app/mcp",
"headers": { "Authorization": "Bearer <токен>" }
}
}
}
Окно Токен выпущен, шаг Подключите агента: выбран Cursor, над блоком подсказка про файл ~/.cursor/mcp.json и кнопка Копировать

Добавьте первые три строки в файл ~/.codex/config.toml, затем выполните строку export в Терминале: Codex CLI читает токен из переменной окружения DEADPOINT_MCP_TOKEN. Запускайте Codex CLI из того же окна Терминала.

[mcp_servers.deadpoint]
url = "https://api.deadpoint.app/mcp"
bearer_token_env_var = "DEADPOINT_MCP_TOKEN"
export DEADPOINT_MCP_TOKEN=<токен>
Окно Токен выпущен, шаг Подключите агента: выбран Codex CLI, подсказка про файл ~/.codex/config.toml и строку export, блок с кнопкой Копировать

Добавьте блок в файл ~/.gemini/settings.json. Если в файле уже есть mcpServers, добавьте в него только запись deadpoint. Перезапустите Gemini CLI.

{
"mcpServers": {
"deadpoint": {
"httpUrl": "https://api.deadpoint.app/mcp",
"headers": { "Authorization": "Bearer <токен>" }
}
}
}
Окно Токен выпущен, шаг Подключите агента: выбран Gemini CLI, подсказка про файл ~/.gemini/settings.json и блок с кнопкой Копировать

Отправьте агенту фразу:

Покажи мои проекты в Dead Point

Связь работает, если агент назвал проекты вашего воркспейса. Пустой список в пустом воркспейсе тоже успех: агент дошёл до Dead Point и получил ответ. Ответ с ошибкой 401 или рассказ, что такого сервера нет, разберите в разделе "Что делать, если не работает".

Окно на последнем шаге предлагает шаблон задания. Замените поля в [скобках] своими данными и отправьте агенту. Для заданий, которые что-то создают или публикуют, нужен токен с правом записи.

Через Dead Point собери черновик оценки в проекте [название проекта].
Вот ТЗ: [вставьте текст ТЗ или ссылку]
Разбей работу на задачи и оцени каждую в [часах или поинтах].
Всё, что неясно в ТЗ, запиши в допущения. Версию не публикуй: я сначала проверю черновик.

Подробности про допущения и метку: ниже, в разделе про сборку оценки из ТЗ.

Открой в Dead Point оценку [название оценки] в проекте [название проекта].
Найди позиции без оценки и задачи крупнее [число] [часов или поинтов].
Составь список замечаний с названиями позиций. Ничего не меняй.
Опубликуй версию оценки [название оценки] в проекте [название проекта] и создай ссылку для клиента [имя клиента].
Согласование отправь на [email клиента].
Пришли мне ссылку и статус согласования.

Подробнее: КП клиенту через агента.

Переведи черновики оценок проекта [название проекта] в [валюту] по курсу [курс].
Сначала покажи превью, применяй после моего подтверждения.

Подробнее: Валюта и копия проекта через агента.

Нужен токен с правом записи. Вставьте ТЗ в агента и попросите, например: "Собери оценку из этого ТЗ в проекте Сайт студии".

  • Агент создаёт в проекте черновик оценки со всеми позициями за один вызов. Если одна позиция неверна, не создаётся ничего.
  • Единицу трудозатрат агент называет сам: часы или поинты по шкале воркспейса. Значение не по шкале сервер отклоняет с подсказкой.
  • Свои допущения (что принято по умолчанию, чего в ТЗ не хватало) агент записывает в оценку.
  • Повторный запрос с тем же ключом не создаёт вторую оценку. Без ключа агент создаст копию.
  • С правом записи публикует версии любой оценки воркспейса и создаёт ссылки для клиента (КП клиенту через агента). Нужно право править оценки проекта.
  • С правом записи меняет ставку, шкалу поинтов и валюту по умолчанию воркспейса, но только после вашего подтверждения превью, и только если токен выпущен владельцем или администратором (Настройки воркспейса через агента).
  • С правом записи переводит черновики оценок проекта в другую валюту по вашему курсу и копирует проект без участников, задач и данных клиентов, но только после вашего подтверждения превью (Валюта и копия проекта через агента).
  • Правит и удаляет позиции только в черновиках, которые сам создал через MCP от вашего имени.
  • Не меняет позиции оценок из приложения и опубликованных версий.
  • Токен только для чтения не пишет ничего.

Оценка, созданная агентом, остаётся черновиком. На странице оценки видны метка "Создано через MCP" и блок "Допущения" с текстом агента. Проверьте их до публикации версии и отправки клиенту.

Токен вставлен с ошибкой, в строку попал лишний пробел или перенос, либо токен отозван. Проверьте строку Authorization: Bearer <токен>. Если токен потерян, выпустите новый (показываем его один раз) и повторите шаг подключения.

Перезапустите агента: конфиг читается при запуске. Проверьте путь к файлу и запятые в JSON. Для Codex CLI убедитесь, что export выполнен в том же окне Терминала, из которого запущен агент. Для Claude Code выполните claude mcp list: в списке должен быть deadpoint.

Ответ quota_exceeded значит, что 100 вызовов в месяц на воркспейс израсходованы: дата сброса указана во вкладке "MCP" и в ответе. Ответ rate_limited значит, что токен превысил 60 вызовов в минуту: повторите запрос через минуту.

  • 100 вызовов в месяц на воркспейс.
  • 60 вызовов в минуту на токен.

Вкладка "MCP" показывает расход: "Использовано N из 100" и дату сброса. Когда месячный лимит исчерпан, во вкладке написано: "Лимит MCP на этот месяц исчерпан". Рядом показана дата сброса, 1-е число следующего месяца UTC. Безлимит появится в тарифе Pro. Агент получает ответ quota_exceeded с лимитом и датой сброса. При превышении минутного лимита ответ rate_limited: повторите запрос через минуту.

Надбавка добавляет вызовов к месячному лимиту воркспейса. Её выдаёт промокод или администратор Dead Point. Во вкладке "MCP" лимит расписан по частям: например, "100 бесплатно + 500 по промокоду до 31 декабря" значит, что в месяц доступно 600 вызовов, пока действует надбавка. Надбавка с датой работает до неё включительно. Потом лимит возвращается к 100 вызовам в месяц, а токены и подключённые агенты продолжают работать. Надбавка без срока действует, пока её не снимут. Минутный лимит в 60 вызовов на токен надбавка не меняет.

Введите код во вкладке "MCP" в блоке "Есть промокод?": поле "Промокод", кнопка "Применить". Код действует на воркспейс, который сейчас открыт в приложении: чтобы добавить вызовы другому воркспейсу, переключитесь на него и введите код там. После успеха вкладка пишет, сколько вызовов добавлено и до какой даты. Если код не подошёл, вкладка объясняет причину:

СообщениеЧто делать
Такого кода нет. Проверьте, что он введён без ошибокСверьте код с письмом или сообщением, в котором его получили
Срок действия кода истёкПопросите новый код
Этот код уже использован максимальное число разПопросите новый код
Этот код уже применён в этом воркспейсеНичего не нужно: надбавка уже действует
Этот код выдан другому пользователюВойдите в аккаунт, которому выдан код, или попросите свой
Этот код не для MCPКод предназначен для другой функции, в MCP он не работает
Слишком много попыток. Повторите через несколько минутПодождите и введите код ещё раз
Не удалось применить код. Попробуйте ещё разПовторите попытку, при повторной ошибке напишите в поддержку

В списке "Ваши токены" нажмите "Отозвать" и подтвердите. Агенты с этим токеном сразу теряют доступ, отменить отзыв нельзя. Если токен попал не туда, отзовите его и выпустите новый.