docs: Add Claude connectors integration guide
Documents MCP connectors available to Claude sessions: - Canva (design generation) - Cloudflare Developer Platform (Workers, Pages, D1, R2) - Stripe (payments, subscriptions, financial data) Includes capabilities, use cases, session startup notes, and product ID reference for Firefrost subscription tiers. Chronicler: #68
This commit is contained in:
Claude
188
docs/integrations/claude-connectors.md
Normal file
188
docs/integrations/claude-connectors.md
Normal file
@@ -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** 💙🔥❄️
|
||||
Reference in New Issue
Block a user