66 lines
No EOL
2.1 KiB
Markdown
66 lines
No EOL
2.1 KiB
Markdown
# 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
|
|
``` |