English Français العربية

Heystack

السجل الرسمي السحابة وDevOps

Observability for AI apps: investigate traces, logs, LLM usage, replays and crashes; manage alerts.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http heystack 'https://mcp.heystack.dev/mcp' --header 'Authorization: <Bearer <Heystack personal access token> (optional — OAuth via Clerk is used when omitted)>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "heystack": {
            "type": "http",
            "url": "https://mcp.heystack.dev/mcp",
            "headers": {
                "Authorization": "<Bearer <Heystack personal access token> (optional — OAuth via Clerk is used when omitted)>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Heystack plugins
  2. Install (Claude Code)
  3. What you get
  4. Other agents
  5. Layout

Heystack plugins

Plugins for Heystack — observability + security for AI apps — so your coding agent can set up Heystack, investigate incidents, and manage your workspace from your editor.

Install (Claude Code)

/plugin marketplace add heystack-hq/heystack-plugins
/plugin install heystack@heystack

Then run /mcp to sign in with Heystack and pick your organization. Try: "list my Heystack apps", "why is /checkout failing since the last deploy?", or "set up Heystack in this project and verify it's receiving data".

What you get

heystack (recommended) — the all-in-one plugin:

  • Hosted MCP server at https://mcp.heystack.dev/mcp (connected with ?toolsets=all): app health, search traces & logs in plain English, open and explain traces, session stories and replays, issues and crashes with the suspect release, gen-AI usage & cost, a one-call incident dossier (heystack_investigate); plus apps, ingest keys, sampling/replay config, alert rules, team and tokens. Sign in with Heystack (OAuth) — no keys to paste. Full reference: https://heystack.dev/docs/mcp
  • heystack-setup skill — detects the runtime (Next.js, Cloudflare Workers/Agents, Node, browser, Android) and wires the correct @heystack/otel entry or OTLP path; with the MCP server it creates the app and key itself and verifies data arrives with heystack_verify_setup.
  • heystack-investigate skill — the investigation loop: overview → dossier → traces/sessions → fix in code → verify; when to change issue status or create alerts; never destructive without your confirmation.

heystack-setup — the setup skill on its own (no MCP server), kept for existing installs: /plugin install heystack-setup@heystack.

Other agents

Layout

.claude-plugin/marketplace.json           # Claude Code marketplace (plugins: heystack, heystack-setup)
plugins/heystack/                         # all-in-one: .mcp.json + skills/
plugins/heystack-setup/                   # skill-only (legacy)
plugin.json · mcp.json · skills/          # Agent Plugins (cross-vendor) layout of the `heystack` plugin

Source of truth for the skills is the heystack monorepo (packages/setup-skill, packages/investigate-skill); this repo is a mirror.

الأسئلة الشائعة

ما هو Heystack؟

Observability for AI apps: investigate traces, logs, LLM usage, replays and crashes; manage alerts.

كيف أثبّت Heystack؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http heystack 'https://mcp.heystack.dev/mcp' --header 'Authorization: <Bearer <Heystack personal access token> (optional — OAuth via Clerk is used when omitted)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Heystack إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل Heystack مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Heystack؟

ينشره heystack-hq. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.