MCP Integration

Ask your AI assistant anything about your project.

Connect Ricca to Claude, Cursor, Windsurf, and any AI app that supports MCP. Query your tags, documents, and assets in plain English. No coding required.

MCP is an open standard that lets AI assistants connect to external data. Think of it like a live data connection between your AI tool and Ricca.

MCP endpointhttps://app.usericca.xyz/api/mcp

How it works

Three steps from question to answer.

01

Open your AI app

Any AI assistant you already use. Claude Desktop, ChatGPT, Gemini, Cursor — no coding required for most of them.

02

Add your API key

Copy your API key from Ricca and paste the config into your AI tool's settings. One time. Five minutes.

03

Ask anything

Your AI now has live access to your instrument tags, document register, and asset data. Plain English in, real answers out.

Connects to

Claude DesktopMac & Windows
ChatGPTDesktop, mobile & web
GeminiWeb & mobile
Claude.aiWeb browser
CursorCode editor
WindsurfCode editor
VS CodeWith Continue
ZedCode editor

Questions your team will ask

Once Ricca is connected, your AI assistant can answer questions about your project data in plain English. No forms, no filters, no spreadsheets.

Instrumentation Engineer

How many pressure transmitters are in area 100, and are they all ISA 5.1 compliant?

Area 100 has 12 pressure transmitters. 10 are compliant. 2 need attention: P-102A should be PT-102A, and PRES-103 should be PT-103.

Document Controller

Which documents in the Condensate Recovery project haven't been reviewed in over 30 days?

6 documents haven't been reviewed in 30+ days. The oldest is P&ID-CR-001 at 52 days. I can draft a transmittal for these if you need it.

Project Engineer

Show me all assets in the register that are missing a manufacturer entry.

17 assets are missing manufacturer info. Most are Rotating Equipment (9 items). Here's the full list sorted by priority.

See it in action

This is a real conversation in Claude Desktop. Ricca processes the request behind the scenes. The engineer just typed a question.

Claude Desktop — Onshore Gas Plant
U

Find all pressure transmitters in area 100 and check if any violate ISA 5.1 naming conventions.

Ricca: searching tags in area 100, type PT, validating ISA 5.1…

Found 8 tags, 2 violations
TagServiceISA 5.1
PT-100Separator inlet✓ Valid
PT-101Compressor suction✓ Valid
P-102ADischarge line✗ Invalid prefix
PT-103Separator outlet✓ Valid
PRES-200Header pressure✗ Non-standard
+ 3 more valid tags
AI

I found 8 pressure transmitters in area 100. Two tags violate ISA 5.1:

  • P-102A → should be PT-102A (missing type designator)
  • PRES-200 → should be PT-200 (non-standard abbreviation)

Get connected

One-time copy-paste. Generate your API key, paste the config into your AI tool, and you're done.

Get your API key

Generate a key from Ricca Settings → API Keys. One-time setup, takes under a minute.

Paste the config

Open your AI tool's MCP settings and paste the block shown. Replace YOUR_API_KEY with your key.

Ask anything

Your AI assistant now has live access to your tags, documents, and assets. Ask in plain English.

Get your API key
Your MCP config
{
  "mcpServers": {
    "ricca": {
      "url": "https://app.usericca.xyz/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Open Settings → Developer → Edit Config, paste the block, replace YOUR_API_KEY, and restart Claude.

Works with

What Ricca can answer

Six built-in capabilities your AI assistant can use the moment Ricca is connected.

Search instrument tags

Find tags by type, service, area, or P&ID reference across your entire project.

Browse document register

Pull up the full document register for any workspace: numbers, revisions, and status.

Query instrument index

Filter your instrument index by loop, tag type, area, or any other field.

Validate tag names

Check any tag against ISA 5.1 conventions and get specific fix suggestions.

Look up assets

Retrieve equipment records with specifications, manufacturer, and location.

Extract from documents

Ask Ricca to extract structured data from any uploaded document.

Ready to connect?

Talk to the team and we'll walk you through connecting Ricca to your AI tool of choice. Takes under five minutes.