| Mode | What you give the AI | API key? | Example |
|---|---|---|---|
| Reference | A read URL to a published guide | No (if public + AI-readable) | "Answer using https://guides.co/g/my-corpus/gdf" |
| Notebook | GDF API or MCP | Yes (or OAuth for ChatGPT App) | "Import this corpus and keep it updated" |
Reference - read-only context; good for RAG fetch benchmarks when your agent already has an HTTP tool.
Notebook - read + write; good for building the corpus, scaffolding sections, and agent-maintained knowledge.
Which app?
| Platform | Notebook setup |
|---|---|
| ChatGPT App | Install Guides → OAuth at mcp.guides.co |
| ChatGPT Custom GPT | Actions → OpenAPI + Bearer key |
| Gemini | Google AI Studio + OpenAPI |
| Claude / Cursor | Local MCP + Bearer key |