Skip to content

MCP Server Quick Start

This guide covers connecting LLM clients to the Cognitive3D MCP Server for natural language queries of your XR analytics data.

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants to connect to external data sources. The Cognitive3D MCP Server lets you query your XR analytics using natural language through compatible AI clients.

Prerequisites

  • A Cognitive3D account with API access
  • Your Organization API Key (format: orgkey-xxxxx)
  • Your Organization ID (numeric)
  • Node.js installed (required for Claude Desktop only)

Finding Your Credentials

Your Organization API Key and Organization ID can be found in the Cognitive3D dashboard under Organization Settings.

the Organization ID is in the URL

  1. Click the gear icon.
  2. Select "Organization Settings".
  3. Locate the number after /organizations/ in the URL. That's your ORG_ID, 76 in this image.

Client Setup

Claude Desktop

  1. Locate your Claude Desktop configuration file:

    Platform Path
    macOS ~/Library/Application Support/Claude/claude_desktop_config.json
    Windows %APPDATA%\Claude\claude_desktop_config.json
    Linux ~/.config/Claude/claude_desktop_config.json

  2. Add the following configuration:

    {
  "mcpServers": {
    "cognitive3d": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://c3d.mcp.cognitive3d.com/sse",
        "--header",
        "X-API-Key:${API_KEY}",
        "--header",
        "X-Org-ID:${ORG_ID}"
      ],
      "env": {
        "API_KEY": "orgkey-YOUR_API_KEY_HERE",
        "ORG_ID": "12345"
      }
    }
  }
}

  3. Replace orgkey-YOUR_API_KEY_HERE with your actual Organization API Key

  4. Replace 12345 with your Organization ID
  5. Restart Claude Desktop

Claude Code

Add the MCP server using the CLI with your credentials:

claude mcp add cognitive3d \
  --transport http \
  https://c3d.mcp.cognitive3d.com/sse \
  --header "X-API-Key: orgkey-YOUR_API_KEY_HERE" \
  --header "X-Org-ID: 12345"

Replace orgkey-YOUR_API_KEY_HERE with your Organization API Key and 12345 with your Organization ID.

ChatGPT

ChatGPT does not currently support MCP connections natively.

Gemini

Google Gemini does not currently support MCP.

Some of the available tools

Once connected, the following tools, plus others, are available:

Tool Description
get_organization_summary Overview of your organization and projects
get_project_details Detailed information about a specific project
compare_projects Compare metrics across multiple projects
get_scene_sessions Session data for a scene
get_project_objectives Objectives and their results

Example Queries

Try asking your AI assistant:

  • "Show me an overview of my organization"
  • "What projects do I have access to?"
  • "What are the recent sessions for project X?"
  • "How are the objectives performing in my training application?"

Troubleshooting

Connection Failed

  • Verify your API key starts with orgkey- (not org-)
  • Confirm your Organization ID is numeric
  • Ensure Node.js is installed and npx is available in your PATH
  • MCP Servers in Claude Desktop require Node.js version 22. Check your version in a terminal with node --version and you can manage node versions with nvm.

No Data Returned

  • Verify you have projects and sessions in your Cognitive3D account
  • Check that your API key has the correct permissions

Authentication Errors

  • Double-check that you're using an Organization API Key, not a Developer API Key
  • Ensure there are no extra spaces in your credentials

intercom If you have a question or any feedback about our documentation please use the Intercom button (purple circle) in the lower right corner of any web page or join our Discord.