What is Perfly MCP?
Perfly MCP is a hosted MCP server that connects coding assistants to Perfly, enabling approved work summaries to be written into your Perfly Today timeline without exposing source code, issue bodies, pull requests, documents, or company SaaS accounts.
How to use Perfly MCP?
Use the hosted MCP endpoint at https://api.perfly.dev/mcp. Perfly supports MCP OAuth for clients that discover authorization from the server, or write-only bearer tokens created in the Perfly app for environments that cannot complete a browser OAuth flow. Detailed setup instructions are available in the mcp/ directory, along with client examples for Claude Code, Codex, and Cursor.
Key features of Perfly MCP
- Exposes tools:
perfly_check_connection, perfly_get_ingestion_policy, perfly_preview_work_items, perfly_add_work_items
- Write-only workflow with user confirmation before submission
- Supports unattended submission when explicitly enabled
- Only accepts summary metadata (titles, optional notes, timestamps, source labels, compact references)
- Protects privacy by blocking source code, secrets, customer data, issue/PR bodies, and document content
Use cases of Perfly MCP
- A coding agent previews and submits concise work summaries to a developer’s Perfly Today timeline
- Managers review Today entries to track progress without granting agents access to sensitive project content
- Developers enable unattended submission for automated daily standup updates
- Teams maintain a privacy boundary while still leveraging AI for status tracking
评论