0c842442bb
App token for Claude access to downloads.firefrostgaming.com. Full admin scope via WebDAV. File structure documented. Claude (Chronicler #82)
238 lines
5.9 KiB
Markdown
238 lines
5.9 KiB
Markdown
# 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** 💙🔥❄️
|
|
|
|
---
|
|
|
|
## NextCloud (downloads.firefrostgaming.com)
|
|
|
|
**Server:** Wiki VPS (64.50.188.14)
|
|
**Version:** 32.0.5
|
|
**URL:** https://downloads.firefrostgaming.com
|
|
**Protocol:** WebDAV
|
|
|
|
**App Token:**
|
|
- Login: `mkrause612`
|
|
- Token: `5apRhbUndEvReViymSQ3PKoOxcWSJYuUETrOvjSzauVchceoN3paGuD8NlA8drKMWgykxsxn`
|
|
- Scope: Full admin
|
|
- Created: April 12, 2026 (Chronicler #82)
|
|
|
|
**WebDAV Base URL:** `https://downloads.firefrostgaming.com/remote.php/dav/files/mkrause612/`
|
|
|
|
**Usage:**
|
|
```bash
|
|
# List files
|
|
curl -u "mkrause612:TOKEN" -X PROPFIND -H "Depth: 1" \
|
|
"https://downloads.firefrostgaming.com/remote.php/dav/files/mkrause612/"
|
|
|
|
# Upload file
|
|
curl -u "mkrause612:TOKEN" -T localfile.txt \
|
|
"https://downloads.firefrostgaming.com/remote.php/dav/files/mkrause612/path/file.txt"
|
|
|
|
# Download file
|
|
curl -u "mkrause612:TOKEN" \
|
|
"https://downloads.firefrostgaming.com/remote.php/dav/files/mkrause612/path/file.txt"
|
|
|
|
# Create folder
|
|
curl -u "mkrause612:TOKEN" -X MKCOL \
|
|
"https://downloads.firefrostgaming.com/remote.php/dav/files/mkrause612/NewFolder/"
|
|
```
|
|
|
|
**Current Structure:**
|
|
```
|
|
Firefrost-Mods/
|
|
└── rules-mod/
|
|
├── neoforge-1.21.1/
|
|
├── forge-1.20.1/
|
|
└── forge-1.16.5/
|
|
Server World Backups/
|
|
├── 2026-03-Retirements/ (7 world backups)
|
|
├── Original stoneblock 4/
|
|
└── Pre Launch Backups/
|
|
```
|