Claude Desktop + Model Context Protocol

The Claude Desktop Database:
Persistent Storage & Observability

Give Claude Desktop persistent operational memory, dynamic schemas, and time-series telemetry. Connect in two minutes via 1-click OAuth 2.1 browser consent — no database migrations, no DDL files, and no manual API key copy-pasting.

Transport

Streamable HTTP

Spec compliant, persistent stream

MCP Endpoint

https://mcp.omnismith.io/mcp

Production gateway endpoint

Authentication

1-Click OAuth 2.1 / Bearer

RFC 8414 & RFC 9728 discovery

Available Tools

50+ Domain Tools

Schemas, entities, telemetry, alerts

Setup Walkthrough

How to Connect Claude Desktop

Choose the native Claude Desktop settings connector, Claude Code CLI, or direct JSON configuration.

Method A (Recommended)

Native Custom Connector via Claude Desktop Settings

The cleanest way to connect Claude Desktop to Omnismith without editing configuration files manually.

  1. 1

    Open Claude Desktop Connectors

    In Claude Desktop, navigate to Customize → Connectors (or Settings → Connectors).

  2. 2

    Add Custom Connector

    Click the + button next to Connectors and select Add custom connector.

  3. 3

    Enter the Omnismith MCP Endpoint

    Set the Connector Name to Omnismith and paste the remote URL:

    https://mcp.omnismith.io/mcp
  4. 4

    Approve 1-Click Browser Consent (OAuth 2.1)

    Click Add. Claude Desktop initiates standard RFC 9728 discovery and automatically opens your browser at the Omnismith Authorization Screen. Select the project you wish Claude to access and click Authorize.

  5. 5

    Ready to Build

    Claude Desktop securely receives the scoped credentials. The Omnismith tool suite is instantly unlocked in Claude's chat bar.

Method B

Claude Code (CLI)

If you interact with Claude via the terminal using Claude Code CLI, add the server in a single command:

claude mcp add omnismith https://mcp.omnismith.io/mcp
Method C

Local Config File (JSON)

For desktop clients connecting via a local bridge runner or headless environments:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "omnismith": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.omnismith.io/mcp"]
    }
  }
}

Headless / Programmatic API Key Alternative

For automated CI/CD runners or background scripts where browser consent is unavailable, pass an API token (omni_live_...) in the headers:

{
  "mcpServers": {
    "omnismith": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.omnismith.io/mcp",
        "--header",
        "Authorization: Bearer omni_live_secret_key_demo"
      ]
    }
  }
}

Real-World Prompts

What You Can Tell Claude to Build

Because Omnismith exposes runtime schemas, Claude can design attributes, templates, and entities on the fly without DDL files or database migrations.

Schema Architecture

"Scaffold a customer deal pipeline in Omnismith with company name, deal stage (Lead, Qualified, Proposal, Won, Lost), expected close date, and deal value."

Copy and paste into Claude Desktop.
Operational Records

"Search for all active servers in the fleet located in region us-east, update their maintenance status to 'Scheduled', and check the field audit history."

Copy and paste into Claude Desktop.
Time-Series Telemetry

"Ingest metric readings for server-01 with cpu_utilization at 42.5% and memory_mb at 8192, then summarize hourly averages over the last 24 hours."

Copy and paste into Claude Desktop.

Why Claude Works Better with Omnismith

Traditional SQL and relational databases assume a human software engineer will write migration files, run deployment scripts, and review schema diffs. When autonomous AI agents work with static schemas, they hit schema locks, permission denials, and broken queries.

1

Runtime Schema Synthesis

Claude can call scaffold_data_model to synthesize custom templates, attributes, and foreign relationships in a single operation without downtime.

2

Tamper-Proof Audit Ledger

Every single entity created, patched, or deleted by Claude carries an immutable audit entry with author attribution and previous/new value snapshots.

3

Native Time-Series Telemetry

Claude can log continuous numeric metrics against any record and query aggregations (avg, max, first, last) with variable time buckets.

4

Project & Role Isolation

Claude sessions are strictly confined to the project you select during authorization, governed by role-based access control (RBAC).

Give your agent somewhere to build.

The free tier carries 250 entities, 25 attributes, and 1,000 AI credits, with the same history, metrics, and API as every other tier. No credit card required.

Start Free

Questions? [email protected]