What your AI can access

Guides notebook connectors are scoped to your personal account - the same account where you created the API key (Studio → Connect an AI) or signed in with OAuth (ChatGPT App).

Pilot eval? Start at the top of this guide - Pilot evaluation - then return here for connector details.

New here? Full account setup and benchmark walkthrough: Connecting AI to Guides (Section 1 = account, Section 2 = connect AI, Section 3 = GDF vs plaintext eval).

What is included:

  • Notebooks on your personal Notebooks shelf (drafts and working guides the AI can edit)
  • Reference guides on your account marked AI-readable (usually read-only unless you ask the AI to edit)

What is not included:

  • Other users' guides
  • Org portal workspaces (unless you use a portal integration key from Settings → Integrations)

How to check access - ask your connected AI:

List my Guides notebooks.

It should call guides_catalog (MCP) or GET /catalog (OpenAPI). The response includes:

  • account_id - confirms which Guides account the connector uses
  • guides[] - each entry has title, slug, kind (notebook or reference), and URLs

If the list is empty, generate demo content first (shopping preferences example) or scaffold a guide. If you get 401, reconnect OAuth or regenerate the API key.