MCP-сервер Attio для Claude Code и Cursor
Подключите агента к CLI для Attio через MCP, посмотрите, что ему доступно, и оставьте запись за собой.
MCP и навыки →Что MCP даёт агенту, как подключить свой клиент и как читать эти доки.Дайте ваши сделки, людей и компании из Attio ИИ-агенту, который не может запускать команды, например Claude Desktop,
Cursor, ChatGPT или Claude в браузере. MCP (Model Context Protocol) это способ, которым такой агент спрашивает
программу, что она умеет, и потом вызывает ее. attio отдает свои команды именно так.
Тогда агент читает ваши сделки, воронку и изменения из копии на вашем компьютере, а людей и компании ищет в Attio, в пределах разрешений профиля.
Агенту с терминалом, например Claude Code или Codex, так же хорошо подходят команды и навык
(attio skill install). Нужен профиль, в который вы вошли (установка), и сначала загляните в
разрешения: через MCP запись на уровне ask выполняется.
На этой странице:
- Подключите attio к агенту
- Что видит агент
- Записи остаются под вашим контролем
- ChatGPT и Claude в браузере
Подключите attio к агенту
attio work mcp add claude-code --allow-writes # or codex
attio work mcp check # the handshake and the tool list, as the client sees them--allow-writes подтверждает, что вы знаете: профиль предлагает инструменты, которые пишут, то есть записи группы
api. Для Claude Desktop, Cursor или любого другого клиента attio work mcp config печатает запись, которую нужно
вставить в его настройки, с полными путями. Вручную для Claude Code:
claude mcp add attio -- attio work mcp serveОдин сервер может обслуживать несколько профилей: attio mcp serve --profiles work,client или --profiles all.
Тогда каждый вызов называет свой профиль, а агент спрашивает вас, если вы не сказали какой.
Что видит агент
У сервера три инструмента:
attio_tools_searchнаходит команду по словам, с ее аргументами и видом ответа.attio_readзапускает команду, которая только читает:{ "command": "deals list", "arguments": { "query": "status:open" } }.attio_writeзапускает команду, которая пишет, например операциюapi, которая создает или удаляет запись.
Команда называется так же, как в командной строке, без профиля, и проверяет тот же ключ разрешения.
Текст из Attio приходит с пометкой untrusted: названия сделок, названия этапов, имена людей и названия компаний,
значения атрибутов и то, что находит search all. Агенту сказано, что это данные, а не инструкции.
Записи остаются под вашим контролем
Команды сделок, людей и компаний только читают. Группа api достает до любой операции Attio, и ее записи по
умолчанию стоят на allow, а удаления на ask. Через MCP в терминале никого нет, чтобы ответить на ask, поэтому
удаление тоже выполняется.
Запись останавливают две вещи. Используйте хотя бы одну, прежде чем добавить сервер:
-
Права токена. Токен только с тремя правами на чтение из раздела установка писать не может: Attio отклоняет запись.
-
Разрешения профиля. Эта строка закрывает любую запись
apiот любого агента на этом профиле, а чтение продолжает работать:attio work config set permissions.api readonly
Чтобы один сервер был строже профиля, дайте ему свои уровни. Профиль они никогда не ослабляют:
attio work mcp add claude-code --allow-writes --permission api=readonly
attio work mcp serve --permission api.objects-records-delete=denyИли включите подтверждение для инструмента attio_write в клиенте агента, чтобы клиент спрашивал вас перед каждой
записью.
ChatGPT и Claude в браузере
Приложение в браузере подключается к серверу по HTTP через ваш собственный туннель, например Tailscale Funnel:
attio work mcp serve --http --public-url https://laptop.example.ts.netСервер слушает только 127.0.0.1, порт 8765 (--port его меняет). Приложение в браузере входит по одноразовому
коду, который печатает команда. attio work mcp revoke завершает все входы.
attio work mcp server start запускает тот же сервер в фоне. mcp server status показывает его порт, код входа и
вошедшие приложения, а mcp server stop его останавливает.
Подробнее: разрешения, безопасность, справочник команд.