@bichito/mcp

MCP server for bichito. Lets your AI assistant (Claude Code, Cursor, Continue, …) drop the bichito bug-report widget into any codebase and triage incoming reports — all without leaving the editor.

What it does

Install the widget (needs BICHITO_API_KEY):

• get_install_snippet — returns the exact snippet for a framework (html / react / next / vue / astro / wp) plus the file it should land in.
• detect_framework — reads package.json (or index.html) at the repo root to guess the framework.
• verify_api_key — pings the bichito API to confirm the key works before the AI pastes it.

Triage your hive (needs BICHITO_MCP_TOKEN, scoped per hive — Pro plan):

• list_honeycombs, list_bugs, get_bug, get_stats
• resolve_bug, mark_spam, assign_me, comment_on_bug, update_bug (set status / severity)
• list_labels, create_label, update_label, delete_label, attach_label, detach_label — manage the team's label catalogue and (de)tag bugs. Listing needs read:labels; catalogue mutations need write:labels; (de)tagging uses write:bugs.

You can run with one or both env vars depending on what you need.

Install

Grab credentials from your hive:

• API key (sk_…) — Settings → API key.
• MCP token (mcp_…) — Settings → MCP. Pick the scopes you want and copy the one-time token.

Claude Code

claude mcp add bichito \
  --env BICHITO_API_KEY=sk_xxx \
  --env BICHITO_MCP_TOKEN=mcp_xxx \
  -- npx -y @bichito/mcp

(Drop either env var if you only need one half of the tools.)

Cursor / Continue / others

Add to the MCP config (typically ~/.config/<tool>/mcp.json):

{
  "mcpServers": {
    "bichito": {
      "command": "npx",
      "args": ["-y", "@bichito/mcp"],
      "env": {
        "BICHITO_API_KEY": "sk_xxx",
        "BICHITO_MCP_TOKEN": "mcp_xxx"
      }
    }
  }
}

Restart your AI tool.

Self-hosted bichito

Set BICHITO_API_URL to your instance (defaults to https://bichito-api.fly.dev):

claude mcp add bichito \
  --env BICHITO_API_KEY=sk_xxx \
  --env BICHITO_API_URL=https://api.example.com \
  -- npx -y @bichito/mcp

Use

Once installed, ask your AI assistant directly:

Install bichito in this project.

It'll detect your framework, verify your key, and edit the right file with the snippet. You can also ask:

What framework does this project use?

Paste the bichito snippet for Next.js into app/layout.tsx.

For triage:

Show me the unresolved bugs from this week.

Resolve bug #42 and leave a note saying it shipped in v1.4.

Mark anything from [email protected] as spam.

Tag bug #42 with the "regression" label and create a "v1.5" label if it doesn't exist yet.

Local development

cd mcp
npm install
npm run build
BICHITO_API_KEY=sk_xxx node dist/index.js

The server speaks MCP over stdio — pair it with mcp-inspector for interactive testing.

License

MIT.