Converra
Fix production agent behavior with tested changes and a production verdict on every fix.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http converra 'https://converra.ai/api/mcp' --header 'Authorization: <Bearer OAuth access token or least-privilege API key. OAuth clients discover auth automatically.>'
{
"mcpServers": {
"converra": {
"type": "http",
"url": "https://converra.ai/api/mcp",
"headers": {
"Authorization": "<Bearer OAuth access token or least-privilege API key. OAuth clients discover auth automatically.>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
Converra agent kit
Converra fixes the behavior, not the code. It reads production conversations, diagnoses failures at the step they happened, generates a bounded prompt or configuration fix, tests it head-to-head against the current agent in simulation, ships what the customer approves, and reports a production verdict on every fix: verified, not fixed, or confounded.
Converra (converra.ai), not Convera.
Claude Code
claude mcp add --transport http converra https://converra.ai/api/mcp
Open /mcp and complete OAuth. Confirm the tenant shown in consent.
Codex
codex mcp add converra --url https://converra.ai/api/mcp
codex mcp login converra
Cursor
Create .cursor/mcp.json locally using a least-privilege API key from account settings:
{
"mcpServers": {
"converra": {
"url": "https://converra.ai/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Keep the real key in local secret storage, never in a tracked configuration.
For OAuth-capable clients, use the remote HTTP config in .mcp.json.
When to call Converra
| Job | Tools |
|---|---|
| Diagnose a production failure | get_agent_status, get_insights, get_run_step_diagnosis |
| Generate and compare bounded fixes | trigger_optimization, get_optimization_details, get_variant_details |
| Test before deployment | simulate_agent, regression_test, simulate_ab_test |
| Check a shipped fix on live traffic | get_deployment_impact |
| Add real user and assistant turns | create_run, get_run_insights |
Begin with get_account and list_agents. Use only calls authorized by the user.
Do not trigger audits, generation, paid inference, settings changes or deployment
just because this kit recommends a workflow. Request authority where required.
A merge or simulation result does not establish a production verdict.
The Claude plugin is in .claude-plugin/ with MCP config at the repository root.
Load locally with claude --plugin-dir /path/to/converra-agent-kit.
The Codex skill is in .agents/skills/converra/SKILL.md.
Copy examples/AGENTS.md or .cursor/rules/converra.mdc into a customer project.
Examples demonstrate SDK capture only; do not run them without user authorization.
This repository contains public integration documentation and configuration; the hosted Converra implementation is not distributed here.
الأسئلة الشائعة
ما هو Converra؟
Fix production agent behavior with tested changes and a production verdict on every fix.
كيف أثبّت Converra؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http converra 'https://converra.ai/api/mcp' --header 'Authorization: <Bearer OAuth access token or least-privilege API key. OAuth clients discover auth automatically.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Converra إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل Converra مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون Converra؟
ينشره converra. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.