Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mirage.strukto.ai/llms.txt

Use this file to discover all available pages before exploring further.

Credentials

1. Create an Internal Integration

  1. Go to My Integrations
  2. Click + New integration
  3. Name it (e.g. “mirage”), select your workspace
  4. Under Content Capabilities, enable:
    • Read content (required)
    • Update content (for write commands)
    • Insert content (for notion-comment-add)
  5. Click Save changes
  6. Copy the Internal Integration Secret (starts with ntn_)

2. Share Pages with the Integration

The integration has no access by default. You must share each page:
  1. Open a Notion page you want to mount
  2. Click ... (top-right) -> + Add connections
  3. Search for your integration name and select it
  4. Child pages inherit the connection - share a top-level page to expose its entire subtree

3. Set Environment Variables

# .env.development
NOTION_API_KEY=ntn_xxxx...
For Python configuration, see the Python Notion Setup guide.