Configure an MCP Client

Overview

Connect your AI client to the platform's MCP server to manage your data using natural language.

Before You Begin

1. Have an API key with the MCP preset (see API Keys)
2. Have an MCP client installed (Claude Desktop, VS Code, Cursor, Claude Code, or n8n)
3. Know your Workspace ID (visible in your workspace settings)

Steps

Claude Desktop

Open the claude_desktop_config.json file and add:

{
  "mcpServers": {
    "ontologie": {
      "url": "https://api.ontologie-growthsystemes.com/api/mcp",
      "headers": {
        "X-API-Key": "df_VOTRE_CLE_MCP",
        "x-workspace-id": "VOTRE_WORKSPACE_ID"
      }
    }
  }
}

VS Code (Copilot MCP Extension)

Add to your settings.json:

{
  "mcp": {
    "servers": {
      "ontologie": {
        "url": "https://api.ontologie-growthsystemes.com/api/mcp",
        "headers": {
          "X-API-Key": "df_VOTRE_CLE_MCP",
          "x-workspace-id": "VOTRE_WORKSPACE_ID"
        }
      }
    }
  }
}

Cursor

Open Settings > MCP Servers and add:

{
  "ontologie": {
    "url": "https://api.ontologie-growthsystemes.com/api/mcp",
    "headers": {
      "X-API-Key": "df_VOTRE_CLE_MCP",
      "x-workspace-id": "VOTRE_WORKSPACE_ID"
    }
  }
}

Claude Code

From your terminal:

claude mcp add ontologie \
  --transport http \
  https://api.ontologie-growthsystemes.com/api/mcp \
  --header "X-API-Key: df_VOTRE_CLE_MCP" \
  --header "x-workspace-id: VOTRE_WORKSPACE_ID"

Or add to your .mcp.json file:

{
  "mcpServers": {
    "ontologie": {
      "type": "http",
      "url": "https://api.ontologie-growthsystemes.com/api/mcp",
      "headers": {
        "X-API-Key": "df_VOTRE_CLE_MCP",
        "x-workspace-id": "VOTRE_WORKSPACE_ID"
      }
    }
  }
}

n8n

In n8n, configure an MCP Client node with:

• URL: https://api.ontologie-growthsystemes.com/api/mcp
• Authentication: Credentials of type "Header Auth"
  • Header X-API-Key with the composite value: YOUR_MCP_KEY:YOUR_WORKSPACE_ID

n8n Format
n8n only supports a single authentication header. The MCP server accepts the composite format api_key:workspace_id in the X-API-Key header.

Security Tip
Store your API key in an environment variable rather than in plain text in the configuration file.

Expected Result

Your AI client is connected to the platform. You can query your data, launch workflows, and search documents from your AI interface.

Limitations / Common Errors

Symptom	Probable Cause	Solution
401 Unauthorized	Invalid or expired API key	Regenerate a key with the MCP preset
403 Forbidden	Missing scope	Add the required scopes to your key
No tools visible	Wrong Workspace ID	Verify the identifier in the settings
Connection dropped	Network timeout	Restart the connection in the client

Need Help?

Contact us: Support and Contact.