perfly-mcp
Perfly Agent Sync is a hosted MCP server for sending approved coding-agent work summaries into perfly.dev.
Что умеет
- Perfly Check Connection: Verify the Perfly Agent Sync token and return token metadata without exposing the secret.
- Perfly Get Ingestion Policy: Return Perfly Agent Sync privacy and formatting rules for local agents.
- Perfly Preview Work Items: Validate worklog items and show what would be submitted to Perfly without inserting records.
Какие данные видит
Нужен ли аккаунт
Не нужен: сервер работает без входа
Perfly Agent Sync is a hosted MCP server for sending approved coding-agent work summaries into perfly.dev. It is built for narrow, write-only ingestion: agents can preview and submit selected summary items, but they cannot read your Perfly history, reports, profile, billing, integrations, or existing work entries.
Как подключить
Как подключить perfly-mcp к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://perfly-mcp--perfly.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить perfly-mcp к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://perfly-mcp--perfly.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить perfly-mcp к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://perfly-mcp--perfly.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (4)
Технические названия из tools/list. Нужны только разработчикам.
| perfly_check_connection | Verify the Perfly Agent Sync token and return token metadata without exposing the secret. |
| perfly_get_ingestion_policy | Return Perfly Agent Sync privacy and formatting rules for local agents. |
| perfly_preview_work_items | Validate worklog items and show what would be submitted to Perfly without inserting records. |
| perfly_add_work_items | Submit user-approved summarized worklog items to Perfly as reviewable Today raw entries. |