Connect AI tools to the Developer Portal with MCP

Connect AI coding assistants and chat tools to the Collibra Developer Portal so they can search and answer questions directly from the documentation.

The Collibra Developer Portal exposes a Model Context Protocol (MCP) server at a fixed URL. You can use AI tools that support MCP over HTTP to search and read the most recent version of the published documentation directly, without any manual copy-pasting or context-loading.

This tutorial walks you through connecting an AI tool to the Developer Portal MCP server and verifying the connection.

MCP server URL

The Developer Portal MCP server is available at:

https://developer.collibra.com/~gitbook/mcp

Opening this URL in a browser returns an error. Use it only in an MCP-compatible tool.

Prerequisites

• An AI tool that supports MCP over HTTP, such as Claude, Claude Code, Codex, Cursor, or VS Code with GitHub Copilot.
• Network access to developer.collibra.com.

The stdio and SSE transports are not supported.

Connect your tool

1

Add the server to your tool

Claude

1. Open Claude and go to Settings → Connectors.
2. Click Add custom connector.
3. Enter the MCP server URL:

   https://developer.collibra.com/~gitbook/mcp

4. Save the connector.

If Claude does not show the option to add custom connectors, your current plan may not support remote MCP connections yet.

Claude Code

Run the following command in your terminal:

claude mcp add --transport http collibra-developer https://developer.collibra.com/~gitbook/mcp

You can replace collibra-developer with any name you prefer.

Codex

Run the following command in your terminal:

codex mcp add collibra-developer https://developer.collibra.com/~gitbook/mcp

Alternatively, add the following to your config.toml:

[mcp_servers.collibra-developer]
url = "https://developer.collibra.com/~gitbook/mcp"

You can replace collibra-developer with any name you prefer.

Cursor

1. Open Settings → MCP.
2. Click Add new MCP server.
3. Enter the MCP server URL:

   https://developer.collibra.com/~gitbook/mcp

Alternatively, add the following to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "collibra-developer": {
      "url": "https://developer.collibra.com/~gitbook/mcp"
    }
  }
}

You can replace collibra-developer with any name you prefer.

VS Code (Copilot)

Add the following to .vscode/mcp.json in your workspace:

{
  "servers": {
    "collibra-developer": {
      "type": "http",
      "url": "https://developer.collibra.com/~gitbook/mcp"
    }
  }
}

You can replace collibra-developer with any name you prefer.

2

Verify the connection

Assuming you named your connection collibra-developer, paste one of the following prompts into your tool to confirm it can read the pages of the Developer Portal:

• Using the collibra-developer MCP server, what authentication methods does the Collibra REST API support?
• Search the Collibra Developer Portal for pagination and summarize the available options.
• List the tools exposed by the collibra-developer MCP server, then find the page about the Import API.

If the tool returns an answer sourced from the Developer Portal, the connection works.

Troubleshooting

If your tool cannot connect:

• Confirm that developer.collibra.com is reachable from your network.
• Confirm that the server URL ends with /~gitbook/mcp and has no trailing characters.
• Confirm that your tool uses HTTP transport, not stdio or SSE.
• Remove and re-add the server if the tool cached a failed state.