MCP knowledge server

Tap into the Platform Orchestrator product knowledge right from your favorite tools using our MCP server.

The Model Context Protocol (MCP)  server provides access to the same Humanitec product knowledge assistant that is available via the interactive widget in the developer docs (use the search bar at the top or the “Ask AI” button bottom right to open the widget).

The assistant and the MCP server are powered by kapa.ai .

The assistant does not have access to any data within your Orchestrator organization. However, when integrated into your own developer AI tooling via MCP, that tooling will be able to combine its contextual data with the product knowledge provided by our assistant to help debug and solve Orchestrator-related tasks.

Why this matters

Engineers spend much of their time in their favorite coding tools, including doing work around the Humanitec Platform Orchestrator. Context switching to research product questions may kill the flow. The MCP server brings all available Orchestrator knowledge right into the setting where it is needed.

Setup

URL: https://humanitec-orchestrator-v2.mcp.kapa.ai

Convenience shortcuts for connecting popular tools are available in the Search & AI widget. Open the widget and select the “Use MCP” dropdown.

Or choose your tool here:

Add the following segment to your .cursor/mcp.json file:

{
  "mcpServers": {
    "humanitec-orchestrator-v2": {
      "type": "http",
      "url": "https://humanitec-orchestrator-v2.mcp.kapa.ai"
    }
  }
}

Prerequisites: VS Code 1.102+ with GitHub Copilot enabled

Create or expand a mcp.json file in your workspace .vscode folder:

{
  "servers": {
    "humanitec-orchestrator-v2": {
      "type": "http",
      "url": "https://humanitec-orchestrator-v2.mcp.kapa.ai"
    }
  }
}

Run the following command in your terminal:

claude mcp add --transport http humanitec-orchestrator-v2 https://humanitec-orchestrator-v2.mcp.kapa.ai

ChatGPT Desktop supports MCP servers in developer mode:

  • Open ChatGPT Desktop
  • Go to Settings > Features
  • Enable Developer mode
  • Navigate to Settings > MCP Servers
  • Click Add Server and enter:
    • Name: humanitec-orchestrator-v2
    • URL: https://humanitec-orchestrator-v2.mcp.kapa.ai

For more information, see the ChatGPT Desktop MCP documentation .

Add this segment to your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "humanitec-orchestrator-v2": {
      "type": "http",
      "url": "https://humanitec-orchestrator-v2.mcp.kapa.ai"
    }
  }
}

Restart Claude Desktop for changes to take effect.

For more details, see the Claude Desktop documentation .

  • Open Cline
  • Select MCP Servers
  • Select Configure
  • Select Configure MCP Servers

Add this segment to the newly opened cline_mcp_settings.json file:

{
  "mcpServers": {
    "humanitec-orchestrator-v2": {
      "disabled": false,
      "timeout": 60,
      "type": "streamableHttp",
      "url": "https://humanitec-orchestrator-v2.mcp.kapa.ai"
    }
  }
}

MCP is an open protocol supported by many clients.

Use the server URL https://humanitec-orchestrator-v2.mcp.kapa.ai and refer to your client’s documentation for setup instructions.

Most clients accept the standard MCP JSON configuration format:

{
  "mcpServers": {
    "humanitec-orchestrator-v2": {
      "url": "https://humanitec-orchestrator-v2.mcp.kapa.ai"
    }
  }
}

Authentication

Using the MCP server requires authentication via a Google account on the first connect.

The authentication does not request the user’s name, email address, or other personal data, from the account. An anonymous, stable user ID is still needed to enforce per-user rate limits and prevent abuse of the backing MCP server provided by kapa.ai . For more details, refer to the kapa.ai product documentation .

Single sign-on (SSO)