Set Up Claude

Connecting Claude to StoryVault takes just a few minutes. You need an API key from StoryVault and a small configuration change in Claude Desktop.

Option 1: Claude Desktop with API Key (Recommended)

Create an API key

In StoryVault, navigate to Admin → API Keys and click “Create New Key”.

Give it a name — for example “Claude Desktop”. Optionally set an expiry date. Click “Create”.

The key is shown only once. Copy it immediately. It always starts with sv_.
Open the configuration file

Open Claude Desktop. Go to Settings → Developer → Edit Config.

Alternatively, open the file directly:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the StoryVault connection

Add the following entry to the configuration file:
```
{
  "mcpServers": {
    "storyvault": {
      "url": "https://app.storyvault.eu/mcp/sse",
      "headers": {
        "Authorization": "Bearer sv_YOUR_KEY_HERE"
      }
    }
  }
}
```
Replace sv_YOUR_KEY_HERE with the copied API key.

If the file already contains other MCP servers, add the "storyvault" entry inside the existing "mcpServers" object.
Restart Claude Desktop

Close Claude Desktop completely and reopen it. The StoryVault icon should appear in the toolbar — the connection is active.
Ask your first question

Test the connection with a concrete question:
- “Show me my latest sessions.”
- “What projects exist in StoryVault?”
- “Read me the transcript from the last team meeting.”
Claude retrieves data live from StoryVault and responds based on your actual content.

If you prefer not to use an API key, you can use the OAuth option:

Enter the StoryVault URL

In the configuration file, enter only the URL — no headers:

{
  "mcpServers": {
    "storyvault": {
      "url": "https://app.storyvault.eu/mcp/sse"
    }
  }
}

Restart Claude Desktop

On the next start, Claude automatically opens a login dialog. Sign in with your StoryVault credentials.
Done

The connection is established automatically. The login token is valid for 24 hours.

Open Integrations

On claude.ai → Settings → Integrations → Add Integration.
Enter the URL

Enter: https://app.storyvault.eu/mcp/sse
Log in

Claude automatically opens a login dialog. Sign in with your StoryVault credentials.
Get started

The integration is active. You can access StoryVault data in any chat.

Problem	Solution
StoryVault icon doesn’t appear	Quit Claude Desktop completely (don’t just minimize) and restart
”Unauthorized” error	Check the API key — is it copied correctly? Does it start with `sv_`?
No data visible	Check whether the API module is activated for your organization
Connection drops	Check your internet connection. The MCP server must be reachable
OAuth login doesn’t appear	Make sure there are no `Authorization` headers in the config

Under Admin → API Keys you can:

The key value itself is only shown at creation and cannot be retrieved later. If you lose a key, simply create a new one and revoke the old one.