Configuration - Ontologie Documentation

Overview

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

Before You Begin

Have an API key with the MCP preset (see API Keys)
Have an MCP client installed (Claude Desktop, VS Code, Cursor, Claude Code, or n8n)
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

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