ghost-mcp/contracts/setup-process.md

Ghost MCP Setup Process Documentation

Phase 0 Research & Setup Progress

Current Status

• ✅ Ghost instance running at http://localhost:2368
• ✅ Ghost admin accessible at http://localhost:2368/ghost
• ✅ MySQL database healthy and connected
• ✅ Ghost initialized with default site (title: "Ghost")
• 🔄 Admin account setup (requires completion)
• ⏳ API key generation (pending admin setup)

Research Findings

• Ghost API is responding correctly
• Admin API requires authentication (expected behavior)
• Site is initialized but admin access needed for API keys

Setup Steps

1. Ghost Admin Account Creation

URL: http://localhost:2368/ghost Status: Needs completion

Steps:

1. Navigate to http://localhost:2368/ghost
2. Complete the Ghost setup wizard:
   • Create admin account (email, password, site title)
   • Complete site configuration
3. Access admin dashboard

2. API Key Generation Process

Status: Pending admin account creation

Steps:

1. In Ghost Admin, navigate to Settings → Integrations
2. Click "Add custom integration"
3. Create integration named "Ghost MCP Development"
4. Copy both API keys:
   • Content API Key: For read-only operations
   • Admin API Key: For read/write operations

3. API Key Testing

Status: Pending API key generation

Tests to perform:

1. Test Content API with key
2. Test Admin API authentication
3. Document authentication flows

Next Steps

1. Complete Ghost admin setup
2. Generate and test API keys
3. Begin API research and documentation

Research Documentation Structure

contracts/
├── setup-process.md          # This file
├── admin-api-auth.md         # JWT authentication research
├── content-api-auth.md       # Content API authentication
├── error-responses.md        # Error response catalog
├── ghost-filtering.md        # Filtering syntax research
├── content-formats.md        # Content format requirements
├── api-endpoints.md          # Complete endpoint catalog
└── rate-limits.md           # Rate limiting behavior