Heystack
Observability for AI apps: investigate traces, logs, LLM usage, replays and crashes; manage alerts.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
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)>'
{
"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)>"
}
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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-setupskill — detects the runtime (Next.js, Cloudflare Workers/Agents, Node, browser, Android) and wires the correct@heystack/otelentry or OTLP path; with the MCP server it creates the app and key itself and verifies data arrives withheystack_verify_setup.heystack-investigateskill — 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
- Cursor / VS Code / Codex / Gemini CLI / Claude.ai connect to the same MCP URL — see https://heystack.dev/docs/mcp for one-click links and commands.
- The skills are plain Agent Skills files and are also served raw at https://heystack.dev/heystack-setup.md and https://heystack.dev/heystack-investigate.md. The root
plugin.json/mcp.json/skills/follow the cross-vendor Agent Plugins layout. - Every docs page is available as Markdown: https://heystack.dev/llms.txt
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.
Questions fréquentes
Qu'est-ce que Heystack ?
Observability for AI apps: investigate traces, logs, LLM usage, replays and crashes; manage alerts.
Comment installer Heystack ?
Il fonctionne comme serveur distant. Dans 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)>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Heystack ?
Oui. Il attend Authorization, à renseigner dans sa configuration.
Heystack est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient Heystack ?
Il est publié par heystack-hq. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.