التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
mcp-runrunitclaude mcp add runrun-it-mcp-server -e 'RUNRUNIT_APP_KEY=<your runrunit_app_key>' -e 'RUNRUNIT_USER_TOKEN=<your runrunit_user_token>' -- npx -y mcp-runrunit@1.0.0
{
"mcpServers": {
"runrun-it-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-runrunit@1.0.0"
],
"env": {
"RUNRUNIT_APP_KEY": "<your runrunit_app_key>",
"RUNRUNIT_USER_TOKEN": "<your runrunit_user_token>"
}
}
}
}
متغيرات البيئة
RUNRUNIT_APP_KEYإلزامي سري Runrun.it API App-Key (application key)RUNRUNIT_USER_TOKENإلزامي سري Runrun.it API User-Token (user authentication)
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
Plugin N1 + MCP runrunit (Cursor)
Plugin do Cursor com regras, skills, agentes, comandos, e MCP para padronizar o trabalho da sua agência.
Estrutura
agency-plugin/
├── .cursor-plugin/
│ └── plugin.json # Manifesto do plugin
├── mcp-runrunit/ # Servidor MCP para Runrun.it (Tasks + Comments + Discord)
├── docs/ # Documentação de referência (API, workflows, entidades)
│ └── Indíce.md # Índice dos tópicos — os agentes consultam esta pasta
├── rules/ # Regras (.mdc)
│ ├── coding-standards.mdc
│ ├── review-checklist.mdc
│ └── docs-reference.mdc # Orienta os agentes a consultar docs/
├── skills/ # Skills do agente
│ └── code-reviewer/
│ └── SKILL.md
├── agents/ # Agentes personalizados
│ └── security-reviewer.md
├── commands/ # Comandos executáveis
│ └── deploy-staging.md
├── hooks/
│ └── hooks.json # Hooks (opcional)
├── assets/
│ └── logo.svg # Logo do plugin
└── README.md
O que está incluído
- Regras: padrões de código, checklist de revisão e referência à pasta
docs/— os agentes são orientados a consultardocs/(e odocs/Indíce.md) para documentação do projeto, API e workflows. - Skills: skill de revisão de código alinhada aos padrões da agência.
- Agentes: revisor de segurança para análise de vulnerabilidades.
- Comandos: exemplo de comando de deploy para staging (edite conforme seu fluxo).
Como usar
- Insira a configuração do MCP no seu Cursor.
json "runrunit-mcp": { "command": "npx", "args": [ "-y", "mcp-runrunit" ], "env": { "RUNRUNIT_APP_KEY": "<APP_KEY>", "RUNRUNIT_USER_TOKEN": "<USER_TOKEN>", "CLOUDINARY_CLOUD_NAME": "<CLOUD NAME>", "CLOUDINARY_API_KEY": "<CLOUDINARY_API_KEY>", "CLOUDINARY_API_SECRET": "<CLOUDINARY_API_SECRET>", "BOT_DISCORD_TOKEN_PUBLIC_ID": "<BOT_DISCORD_TOKEN_PUBLIC_ID>", "BOT_RUNRUNIT_REPORT_PRIVATE_KEY": "<BOT_RUNRUNIT_REPORT_PRIVATE_KEY>", "DISCORD_GUILD_ID": "<DISCORD_GUILD_ID>", "DISCORD_CHANNEL_ID": "<DISCORD_CHANNEL_ID>" } },** > Substitua os valores entre "" acima por chaves reais - As credenciais do runrunit, basta pegar no perfil. https://i.imgur.com/qT6Xmcz.png
Obter as credenciais do Cloudinary (bucket online para hospedagem de imagens, disponibiliza links para as documentações)
2.1 Faça login/registro https://cloudinary.com/users/register_free (Utilize sua conta google ou Github)
- As variaveis do Discord hoje são uma utilização opicional, visando implementação futura onde iremos unificar os canais dos clientes com os gestores sinalizando andamentos, impeditivos, finalizações ou qualquer outro evento relevante para o acompanhamento.
Skills disponíveis no README.md do MCP
Publicação
Para publicar no marketplace do Cursor:
- Hospede o plugin em um repositório Git público.
- Acesse cursor.com/marketplace/publish e envie o link do repositório.
- Confira o guia de criação de plugins para o checklist de envio.
Licença
Ajuste conforme a licença da sua agência (ex.: MIT, proprietária).
الأسئلة الشائعة
ما هو Runrun.it MCP Server؟
MCP server for Runrun.it: Tasks, Comments, Projects
كيف أثبّت Runrun.it MCP Server؟
يعمل على جهازك. في Claude Code: claude mcp add runrun-it-mcp-server -e 'RUNRUNIT_APP_KEY=<your runrunit_app_key>' -e 'RUNRUNIT_USER_TOKEN=<your runrunit_user_token>' -- npx -y mcp-runrunit@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Runrun.it MCP Server إلى مفتاح API؟
نعم. يتطلب RUNRUNIT_APP_KEY, RUNRUNIT_USER_TOKEN، وتضبطها في إعداداته.
هل Runrun.it MCP Server مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون Runrun.it MCP Server؟
ينشره zNetinho. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.