Comma
Publish HTML reports to a share link, collect anchored comments, revise at the same URL.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http comma 'https://commareports.com/api/mcp' --header 'Authorization: <Bearer comma_sk_... token (free). Create one at commareports.com: Settings > API tokens > New token.>'
{
"mcpServers": {
"comma": {
"type": "http",
"url": "https://commareports.com/api/mcp",
"headers": {
"Authorization": "<Bearer comma_sk_... token (free). Create one at commareports.com: Settings > API tokens > New token.>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
Comma plugin for Claude Code
Publish, search, and link to Comma reports without leaving your Claude Code session — plus an interactive review flow that feeds your anchored comments back to Claude as structured feedback.
This repository is an auto-published mirror. The source of truth lives in the main Comma repository (private) and a GitHub Action pushes changes here. Issues and pull requests opened here won't be seen — report problems via https://commareports.com/contact.
Install (one line)
curl -fsSL https://commareports.com/install.sh | bash
Windows (PowerShell):
iwr -useb https://commareports.com/install.ps1 | iex
Manual install
# 1. Add the marketplace (this repo)
claude plugin marketplace add doramirdor/comma-plugin
# 2. Install the plugin
claude plugin install comma@comma
# 3. Export your token (put this in your shell profile)
export COMMA_API_TOKEN=comma_sk_your_token_here
Mint a token at https://commareports.com/settings?section=tokens — it starts
with comma_sk_. Restart Claude Code after installing so it picks up
the plugin's MCP attachment.
What you get
| Command | What it does |
|---|---|
/comma-publish [title] | Publishes the assistant's most recent reply as an HTML report and returns the URL. |
/comma-publish-last [title] | Alias for /comma-publish. |
/comma-search <query> | Full-text searches your existing reports. |
/comma-routine [description] | Lists your routines, or sets up a scheduled routine on a report. |
/comma-link <report_id> | Resolves a report id to its title + share URL. |
/comma-review <file> | Opens a file in your browser for anchored comments, then feeds them back to Claude. |
Plus the publish-as-report skill, which triggers automatically on
natural-language publish intent ("share this as a report"), and an MCP
attachment to the hosted server at https://commareports.com/api/mcp —
full tool table at https://commareports.com/docs/mcp.
Docs
- Quickstart: https://commareports.com/docs/quickstart
- Claude Code setup: https://commareports.com/mcp/claude-code
- Plugin docs: https://commareports.com/docs/claude-code-plugin
License
MIT.
الأسئلة الشائعة
ما هو Comma؟
Publish HTML reports to a share link, collect anchored comments, revise at the same URL.
كيف أثبّت Comma؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http comma 'https://commareports.com/api/mcp' --header 'Authorization: <Bearer comma_sk_... token (free). Create one at commareports.com: Settings > API tokens > New token.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Comma إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل Comma مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون Comma؟
ينشره doramirdor. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.