Context Repo DocsSettings
Manage your API keys and permission scopes to integrate Context Repo with external tools and services.
The Settings page has two tabs: API Keys for managing programmatic access to your account, and Model Preferences for configuring default AI model settings (coming soon).
API Keys
API keys let external tools — like the Chrome Extension, MCP clients, and custom scripts — access your Context Repo data. You can create multiple keys with different permission scopes and revoke any of them at any time.
Creating an API Key
Click New API Key in the top-right corner of the API Keys tab to open the creation dialog. You'll see these fields:
| Field | Required | Description |
|---|---|---|
| Name | Yes | A label to help you remember what this key is used for (e.g., "Chrome Extension" or "CI Pipeline") |
| Permissions | Yes | One or more scopes that control what this key can access (see Permission Scopes below) |
| Expires | No | An optional expiration date — if left blank, the key doesn't expire |
After you click Create, the full API key is displayed once. Copy it immediately and store it somewhere safe — you won't be able to see the full key again.
Treat your API keys like passwords. Don't share them in public repositories, chat messages, or unencrypted files. If a key is compromised, revoke it immediately and create a new one.
Permission Scopes
Each API key is assigned one or more permission scopes that control what it can access:
| Scope | Label | What It Allows |
|---|---|---|
prompts.read | Prompts API access | Full access to prompts through the MCP and REST APIs — listing, creating, updating, deleting, restoring versions, and searching |
documents.read | Documents & Collections API access | Full access to documents and collections through the MCP and REST APIs — creating, reading, updating, deleting, restoring versions, scraping URLs, managing collection items, and deep search |
When creating a key, select one or both scopes based on what your integration needs.
The Chrome Extension needs at minimum the documents.read scope to save scraped web pages to your account. Most integrations work best with both scopes enabled.
Viewing Your Keys
The API Keys tab displays a table of all your active keys. Each row shows:
- Name — the label you gave the key when you created it
- Permissions — badges showing which scopes are assigned
- Created — when the key was created
- Last used — the most recent time the key was used to make an API call
- Expires — the expiration date, if one was set
Revoking a Key
To revoke an API key, click the delete icon on the key's row in the table. You'll see a confirmation dialog before the key is permanently deactivated.
Revoked keys stop working immediately — any tool or integration using that key will receive authentication errors until you provide a new one.
Model Preferences
Model Preferences is coming soon. This tab is currently disabled. Once available, it will let you configure default provider and model selection settings for your workspace tools.
Related Pages
Collection Chat
Have AI-powered conversations about the contents of your collections, with source citations and a dedicated artifact panel.
MCP Server
Connect your AI assistant to Context Repo with the Model Context Protocol (MCP). Access 26 tools for managing prompts, documents, collections, and search — directly from Claude, Cursor, VS Code, and more.