Skip to content

MCP Server

Overview

The Model Context Protocol (MCP) server allows you to connect Trust3 IQ with any AI agent or assistant. Instead of manually stitching together context, AI agents can query IQ spaces using natural language and retrieve unified enterprise context that includes:

  • Business concepts and semantics
  • Data relationships and metadata
  • Metrics and calculations
  • Governance rules and access policies

Benefits

  • Universal Integration: Connect with popular AI assistants like Claude, ChatGPT, or custom agents built using agentic platforms such as LangGraph, CrewAI, and n8n
  • Reusable Context: Build context once in IQ and reuse across multiple AI applications and domains
  • Business-Aware Intelligence: AI agents receive accurate, governed context based on your actual data semantics
  • Standardized Protocol: Use industry-standard MCP protocol for reliable, consistent integration

Prerequisites

Before configuring MCP client connections, ensure you have:

Requirement Description
IQ Space An active IQ Space created in Trust3 IQ UI (see Creating IQ Spaces)
API Key Authentication key for accessing the MCP server. Contact Trust3 team at support@trust3.ai to obtain API keys
MCP Host Hostname or IP address where Trust3 IQ MCP server is running

IQ Space Required

The x-space value in your configuration must correspond to an IQ space that has been created in the Trust3 IQ UI. You need to first create your IQ space through the Trust3 IQ interface, then use that exact space name in your configuration.

MCP Client Configuration

Your AI agent or client will need to configure the MCP connection settings. Below is the configuration structure needed for MCP-compliant clients:

Basic Configuration

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
{
  "mcpServers": {
    "trust3-iq-mcp-client": {
      "transport": "streamable_http",
      "url": "http://<mcp-host>:8000/mcp",
      "headers": {
        "Accept": "application/json, text/event-stream",
        "x-space": "<iq-space-name>",
        "x-api-key": "<api-key>"
      },
      "timeout": 600
    }
  }
}

Configuration Fields

Field Description
transport Communication protocol. Use "streamable_http" for HTTP-based streaming
url MCP server endpoint URL with your host address and port. Default port is 8000. Format: http://<mcp-host>:8000/mcp
x-space Name of the IQ space to use. Must match an IQ space created in Trust3 IQ UI
x-api-key Authentication key for accessing the MCP server. Contact Trust3 team at support@trust3.ai to obtain API keys
timeout Maximum time in seconds to wait for server response. Default is 600 seconds

Troubleshooting

Common Issues

Issue Common Causes Solution
Connection refused Wrong host or port Verify MCP server URL and port (default: 8000)
Authentication failed Invalid API key Verify API key is correct and hasn't expired
IQ Space not found Wrong space name Ensure IQ space name matches exactly (case-sensitive)
Timeout errors Network issues or slow queries Increase timeout value or check network connectivity
Invalid request format Incorrect headers or body Verify all required headers are present and correctly formatted

Best Practices

Query Optimization

  • Be Specific: Ask specific questions rather than vague queries
  • Progressive Queries: Start with broad questions, then narrow down
  • Context Awareness: Reference previous queries when appropriate

Next Steps