specs/003-chatgpt-app-integration/quickstart.md

Quickstart: ChatGPT App Integration

Prerequisites

• Existing backend running.
• CHATGPT_SERVICE_TOKEN set in environment.

Testing the Integration

1. Authentication

# Test service token access
curl -H "Authorization: Bearer <your-service-token>" http://localhost:8000/api/notes

2. Widget Serving

# Test widget endpoint
curl -v http://localhost:8000/widget/note
# Expect: Content-Type: text/html+skybridge (or similar)

3. Tool Metadata

# Test tool call via /mcp endpoint
curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "read_note",
      "arguments": {"note_path": "Welcome.md"}
    },
    "id": 1
  }'
# Expect response to contain _meta.openai.outputTemplate