MCP: подключение агента
Что такое MCP
Заголовок раздела «Что такое MCP»MCP (Model Context Protocol) это способ дать ИИ-агенту доступ к вашим проектам и оценкам в Dead Point. Агент (Claude Code, Cursor, Codex CLI или Gemini CLI) читает оценки, а с правом записи собирает черновики, публикует версии и создаёт ссылки для клиента. Доступ даёт токен: он работает как пароль, поэтому храните его так же и выпускайте отдельный токен на каждого агента. Пользоваться можно бесплатно: 100 вызовов в месяц на воркспейс и 60 вызовов в минуту на токен.
Выпустить токен
Заголовок раздела «Выпустить токен»- Откройте "Аккаунт", вкладку "MCP".
- Введите название токена, например "Claude Code на ноутбуке".
- Выберите доступ, нажмите "Выпустить токен".
- Скопируйте токен. Показываем токен один раз: потом посмотреть его не получится.
Токен хранится как пароль. Выпустите отдельный токен на каждого агента, так его проще отозвать.
Доступ токена
Заголовок раздела «Доступ токена»| Доступ | Что может агент |
|---|---|
| Только чтение | Видит проекты и оценки |
| Чтение и черновики оценок | Ещё создаёт черновики оценок, правит или удаляет позиции в черновиках, созданных через MCP от вашего имени, публикует версии любой оценки воркспейса и создаёт ссылки для клиента, если у вас есть право править оценки проекта (КП клиенту через агента) |
Запись выбирайте только для клиента, которому доверяете. Запрос на запись с токеном только для чтения получает отказ.
Подключить агента
Заголовок раздела «Подключить агента»После выпуска токена окно "Токен выпущен" ведёт по четырём шагам: сохранить токен, подключить агента, проверить связь, дать первое задание. Ниже тот же второй шаг по каждому агенту. Токен в строках уже подставлен окном, здесь он показан как <токен>. Адрес сервера на снимках условный: берите строку из своего окна.
Claude Code
Заголовок раздела «Claude Code»Откройте Терминал и вставьте команду. Сервер добавится в настройки Claude Code, перезапуск не нужен.
claude mcp add --transport http deadpoint https://api.deadpoint.app/mcp --header "Authorization: Bearer <токен>"
Добавьте блок в файл ~/.cursor/mcp.json. Если в файле уже есть mcpServers, добавьте в него только запись deadpoint. Перезапустите Cursor.
{ "mcpServers": { "deadpoint": { "url": "https://api.deadpoint.app/mcp", "headers": { "Authorization": "Bearer <токен>" } } }}
Codex CLI
Заголовок раздела «Codex CLI»Добавьте первые три строки в файл ~/.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=<токен>
Gemini CLI
Заголовок раздела «Gemini CLI»Добавьте блок в файл ~/.gemini/settings.json. Если в файле уже есть mcpServers, добавьте в него только запись deadpoint. Перезапустите Gemini CLI.
{ "mcpServers": { "deadpoint": { "httpUrl": "https://api.deadpoint.app/mcp", "headers": { "Authorization": "Bearer <токен>" } } }}
Проверить подключение
Заголовок раздела «Проверить подключение»Отправьте агенту фразу:
Покажи мои проекты в Dead PointСвязь работает, если агент назвал проекты вашего воркспейса. Пустой список в пустом воркспейсе тоже успех: агент дошёл до Dead Point и получил ответ. Ответ с ошибкой 401 или рассказ, что такого сервера нет, разберите в разделе "Что делать, если не работает".
Примеры заданий
Заголовок раздела «Примеры заданий»Окно на последнем шаге предлагает шаблон задания. Замените поля в [скобках] своими данными и отправьте агенту. Для заданий, которые что-то создают или публикуют, нужен токен с правом записи.
Черновик оценки из ТЗ
Заголовок раздела «Черновик оценки из ТЗ»Через Dead Point собери черновик оценки в проекте [название проекта].Вот ТЗ: [вставьте текст ТЗ или ссылку]Разбей работу на задачи и оцени каждую в [часах или поинтах].Всё, что неясно в ТЗ, запиши в допущения. Версию не публикуй: я сначала проверю черновик.Подробности про допущения и метку: ниже, в разделе про сборку оценки из ТЗ.
Разбор готовой оценки
Заголовок раздела «Разбор готовой оценки»Открой в Dead Point оценку [название оценки] в проекте [название проекта].Найди позиции без оценки и задачи крупнее [число] [часов или поинтов].Составь список замечаний с названиями позиций. Ничего не меняй.Версия и ссылка клиенту
Заголовок раздела «Версия и ссылка клиенту»Опубликуй версию оценки [название оценки] в проекте [название проекта] и создай ссылку для клиента [имя клиента].Согласование отправь на [email клиента].Пришли мне ссылку и статус согласования.Подробнее: КП клиенту через агента.
Перевод в другую валюту
Заголовок раздела «Перевод в другую валюту»Переведи черновики оценок проекта [название проекта] в [валюту] по курсу [курс].Сначала покажи превью, применяй после моего подтверждения.Подробнее: Валюта и копия проекта через агента.
Собрать оценку из ТЗ
Заголовок раздела «Собрать оценку из ТЗ»Нужен токен с правом записи. Вставьте ТЗ в агента и попросите, например: "Собери оценку из этого ТЗ в проекте Сайт студии".
- Агент создаёт в проекте черновик оценки со всеми позициями за один вызов. Если одна позиция неверна, не создаётся ничего.
- Единицу трудозатрат агент называет сам: часы или поинты по шкале воркспейса. Значение не по шкале сервер отклоняет с подсказкой.
- Свои допущения (что принято по умолчанию, чего в ТЗ не хватало) агент записывает в оценку.
- Повторный запрос с тем же ключом не создаёт вторую оценку. Без ключа агент создаст копию.
Что агент меняет, а что нет
Заголовок раздела «Что агент меняет, а что нет»- С правом записи публикует версии любой оценки воркспейса и создаёт ссылки для клиента (КП клиенту через агента). Нужно право править оценки проекта.
- С правом записи меняет ставку, шкалу поинтов и валюту по умолчанию воркспейса, но только после вашего подтверждения превью, и только если токен выпущен владельцем или администратором (Настройки воркспейса через агента).
- С правом записи переводит черновики оценок проекта в другую валюту по вашему курсу и копирует проект без участников, задач и данных клиентов, но только после вашего подтверждения превью (Валюта и копия проекта через агента).
- Правит и удаляет позиции только в черновиках, которые сам создал через MCP от вашего имени.
- Не меняет позиции оценок из приложения и опубликованных версий.
- Токен только для чтения не пишет ничего.
Допущения и метка на странице оценки
Заголовок раздела «Допущения и метка на странице оценки»Оценка, созданная агентом, остаётся черновиком. На странице оценки видны метка "Создано через MCP" и блок "Допущения" с текстом агента. Проверьте их до публикации версии и отправки клиенту.
Что делать, если не работает
Заголовок раздела «Что делать, если не работает»Ошибка 401
Заголовок раздела «Ошибка 401»Токен вставлен с ошибкой, в строку попал лишний пробел или перенос, либо токен отозван. Проверьте строку 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 он не работает |
| Слишком много попыток. Повторите через несколько минут | Подождите и введите код ещё раз |
| Не удалось применить код. Попробуйте ещё раз | Повторите попытку, при повторной ошибке напишите в поддержку |
Отозвать токен
Заголовок раздела «Отозвать токен»В списке "Ваши токены" нажмите "Отозвать" и подтвердите. Агенты с этим токеном сразу теряют доступ, отменить отзыв нельзя. Если токен попал не туда, отзовите его и выпустите новый.