diff --git a/docs/integrations/claude-connectors.md b/docs/integrations/claude-connectors.md new file mode 100644 index 0000000..db996fb --- /dev/null +++ b/docs/integrations/claude-connectors.md @@ -0,0 +1,188 @@ +# Claude Connectors — Firefrost Integration Guide + +**Created:** April 8, 2026 +**Created By:** Chronicler #68 +**Purpose:** Document MCP connectors available to Claude for Firefrost operations + +--- + +## Overview + +Claude connectors are MCP (Model Context Protocol) integrations that give Claude direct access to external services. These are tied to **Michael's Claude account**, not project instructions — they persist across all chats and projects. + +--- + +## Active Connectors + +### ✅ Canva + +**Purpose:** Design generation and management + +**Capabilities:** +- Search existing designs +- Create new designs (presentations, social posts, documents) +- Autofill templates +- Export designs as PDF/images +- Generate designs from prompts + +**Use Cases for Firefrost:** +- FOMO campaign graphics +- Social media posts +- Marketing materials +- Presentation decks + +**Example:** +``` +"Search for my recent Firefrost designs" +"Create an Instagram post about our Minecraft servers" +``` + +--- + +### ✅ Cloudflare Developer Platform + +**Purpose:** Workers, Pages, and infrastructure management + +**Account ID:** `b253db7a7ff86b35307206dac9476c89` +**Note:** Account ID must be set each session with `set_active_account` + +**Capabilities:** +- List/view Workers +- Get Worker source code +- Search Cloudflare documentation +- Manage D1 databases, R2 buckets, KV stores + +**Current Workers:** +- `servers-api` — Proxies Pterodactyl API for website server status + +**Use Cases for Firefrost:** +- Retrieve Worker code (now in git: `firefrost-services/cloudflare-workers/`) +- Deploy Worker updates +- Search Cloudflare docs for implementation help + +**Example:** +``` +"Get the servers-api Worker code" +"Search Cloudflare docs for how to set up KV storage" +``` + +--- + +### ✅ Stripe + +**Purpose:** Payment processing and financial data + +**Capabilities:** + +**Read Operations:** +- List customers, subscriptions, invoices, payments +- Search across resources with complex queries +- Fetch detailed object info by ID +- List disputes and refunds + +**Write Operations:** +- Create customers, invoices, prices, payment links +- Update subscriptions +- Cancel subscriptions +- Process refunds (requires human approval) +- Submit dispute evidence +- Create coupons + +**Documentation:** +- Search Stripe docs by question +- Get API implementation details +- Integration recommendations + +**Use Cases for Firefrost:** +- View subscriber status +- Debug payment issues +- Look up webhook event types for Arbiter +- Check product/price configuration + +**Example:** +``` +"List all active subscriptions" +"Search Stripe docs for cancellation webhook events" +"What products are configured?" +``` + +**Current Firefrost Products:** +| Tier | Fire Product ID | Frost Product ID | +|------|-----------------|------------------| +| Awakened | prod_UGp8bRpm0C72tV | (single) | +| Elemental | prod_UGp85wvlABvjOM | prod_UGp838XQJUHKjL | +| Knight | prod_UGp8H8Yo4aUszs | prod_UGp8lGymToNpFC | +| Master | prod_UGp8zI5Rl6Z5Fq | prod_UGp8Wt7t0f9iXW | +| Legend | prod_UGp8AKGcicXLAP | prod_UGp8gWzTLWCkis | +| Sovereign | prod_UGp8KSzb72RaCr | (single) | + +--- + +## Available (Not Actively Used) + +### Google Calendar +- View calendars and events +- Create/manage events +- Find meeting times +- **Status:** Available but not integrated into Firefrost workflow + +### Gmail +- Search/read emails +- Create drafts +- **Status:** Available but not integrated into Firefrost workflow + +### Mermaid Chart +- Validate Mermaid syntax +- Render diagrams as SVG +- **Status:** Available for diagram work + +--- + +## Not Available / Skipped + +### n8n +- **Reason:** Cloud-only — doesn't work with self-hosted instances +- **Workaround:** Trigger n8n workflows via web UI or webhooks + +### GitHub +- **Reason:** Native Claude feature, not MCP connector +- **Notes:** Low value for Firefrost since we use Gitea + +--- + +## Session Startup Notes + +**Cloudflare requires account activation each session:** +``` +Cloudflare Developer Platform:set_active_account + activeAccountIdParam: "b253db7a7ff86b35307206dac9476c89" +``` + +**Canva and Stripe work immediately** — no session setup required. + +--- + +## Adding New Connectors + +1. Go to Claude Settings → Connectors +2. Browse available connectors +3. Click Connect and authorize +4. Test in chat +5. Document here if useful for Firefrost + +**Evaluation Criteria:** +- Does it integrate with services Firefrost actually uses? +- Does it work with self-hosted instances (if applicable)? +- Does it provide value beyond what's already available? + +--- + +## Version History + +| Date | Change | By | +|------|--------|-----| +| 2026-04-08 | Initial documentation | Chronicler #68 | + +--- + +**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️