Connect Trovella to Your AI Tools

Overview

Trovella connects to your existing AI tools through the Model Context Protocol (MCP). Once connected, your AI assistant gains access to Trovella's cross-platform memory, research engine, and curated skills — without leaving the tool you already use.

This guide walks you through creating a Personal Access Token, configuring your AI tool, and verifying the connection.

Step 1: Create a Personal Access Token

A Personal Access Token (PAT) authenticates your AI tool with Trovella. Each token is tied to your account and workspace.

1. Sign in to Trovella and go to Settings
2. Scroll to the Personal Access Tokens section
3. Click Create Token
4. Enter a name that identifies the tool (e.g., "Claude Desktop" or "ChatGPT")
5. Optionally set an expiration date — tokens without an expiration never expire, but rotating tokens periodically is recommended
6. Click Create
7. Copy the token immediately — it's shown only once and cannot be retrieved later

Your token looks like trov_ followed by 40 characters. Keep it secret — anyone with your token can access your Trovella account through the MCP server.

Step 2: Configure Your AI Tool

After creating a token, Trovella shows a configuration block you can copy directly into your AI tool.

Claude Code / Claude Desktop

Add this to your MCP configuration:

{
  "mcpServers": {
    "trovella": {
      "type": "http",
      "url": "https://trovella.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Replace YOUR_TOKEN_HERE with the token you copied.

Other AI Tools

Any tool that supports the Model Context Protocol can connect to Trovella. Use these details:

• Server URL: https://trovella.ai/api/mcp
• Authentication: Bearer token in the Authorization header
• Protocol: HTTP-based MCP (not stdio)

Step 3: Verify the Connection

Once configured, ask your AI tool to run the Trovella ping command. You should see a response like:

Connected to Trovella as Jane Smith (jane@example.com).

If you see this, Trovella's tools are available in your AI assistant.

Managing Your Tokens

Viewing Tokens

Go to Settings → Personal Access Tokens to see all your tokens. Each shows:

• Name — the label you gave it
• Prefix — the first few characters (for identification)
• Created — when it was created
• Last used — when the token was last used for an MCP request
• Expires — the expiration date, or "Never" if no expiration was set

Revoking a Token

If a token is compromised or no longer needed, revoke it immediately:

1. Go to Settings → Personal Access Tokens
2. Click Revoke next to the token
3. Confirm the revocation

Revoked tokens stop working immediately. Any AI tool using that token will lose access and need a new token to reconnect.

Token Security

• Never share your token in chat messages, emails, or public repositories
• Use one token per tool so you can revoke access to a single tool without affecting others
• Rotate tokens periodically — create a new token, update your tool's config, then revoke the old one
• Set expiration dates for tokens used in shared environments

Troubleshooting

• "Unauthorized" error: Your token may be expired or revoked. Create a new one in Settings.
• "Connection refused": Verify the URL is exactly https://trovella.ai/api/mcp with no trailing slash.
• Tools not appearing: After configuring the MCP server, restart your AI tool or reload its configuration.

Next Steps

• Learn about cross-platform memory and how Trovella remembers context across your AI tools
• See the full MCP tools reference for every tool available through the connection
• Try running a research plan through your connected AI tool