MCP Setup (Claude, Cursor, Codex)

The MCP server gives your assistant 4 tools (remember/recall/context/list). Works with local CLI tools and remote chat connectors.

One Command (CLI Tools)

For Claude Code, Cursor, and Codex-run setup from your project directory:

terminal
npx veriova-mcp@latest setup

At the API key prompt, type open to open signup, generate an API key, then paste it back into the terminal.

What Setup Does (And Does Not Do)

Setup configures your MCP client to launch npx veriova-mcp with environment variables. It does not upload your API key anywhere except to veriova API calls you explicitly make.

env
VERIOVA_API_KEY=cv_...
VERIOVA_BASE_URL=https://veriova.com
VERIOVA_PROJECT=<selected project slug>

Claude Desktop

Add veriova to your Claude Desktop config file:

~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "veriova": {
      "command": "npx",
      "args": ["veriova-mcp@latest"],
      "env": {
        "VERIOVA_API_KEY": "cv_your_key_here",
        "VERIOVA_PROJECT": "your-project-slug",
        "VERIOVA_BASE_URL": "https://veriova.com"
      }
    }
  }
}

On Windows, the config file is at %APPDATA%\Claude\claude_desktop_config.json. Restart Claude Desktop after editing.

Claude Chat (Remote MCP Connector)

Claude Chat supports remote MCP servers-no local setup needed. Connect via:

  1. Open Claude Chat and go to Settings -†- Integrations -†- Add MCP Server.
  2. Enter the remote MCP URL: https://mcp.veriova.com/mcp
  3. You'll be redirected to sign in with your veriova account. The OAuth flow creates an API key automatically-no manual key pasting required.
  4. After authorization, the 4 tools (veriova_remember, veriova_recall, veriova_context, veriova_list) will appear in your chat.

Project Selection (This Prevents “Project Not Found”)

During setup, veriova fetches your projects and lets you choose from a list. The default suggestion is derived from your current folder name (workspace slug).

Example: if you run setup inside a folder named veriova, it will suggest veriova as a slug.

Verification

terminal
# Claude Code
claude mcp list

# Codex
codex mcp list

If tools are enabled, your assistant should be able to call:veriova_remember, veriova_recall, veriova_context, veriova_list.

Doctor (Fast Diagnostics)

terminal
npx veriova-mcp@latest doctor

This checks connectivity, API key validity, and whether the configured project slug exists.

Cursor Notes

On some Cursor builds, the CLI MCP add command is unreliable. Setup automatically falls back to writing .cursor/mcp.json in your repo and adds .cursor/ to .gitignore to avoid committing secrets.