Register an MCP server to add it to the inventory of tool servers that your AI agents can use. After you register it, you can discover its tools with the Collibra CLI and classify them.
You can register an MCP server in two ways:
- Directly from the registry, in the same way as you register an AI use case or an AI model.
- From a related asset, for example an AI use case, so that the MCP server is linked to that asset right away.
TBC - the code shows only one entry point, the registry. Confirm whether you can also register an MCP server from a related asset.
Prerequisites
- MCP governance is enabled.
- You have a resource role with the Asset > Add resource permission on the domain where you register the MCP server. This is the same permission that you need to register any other asset. No global permission is required.
- You know the address (URL) of the MCP server, which comes from the tool provider.
Steps
- In the registry, click the arrow next to the Register AI use case button, and then select Register MCP server.
The Register MCP server registration form opens. - Enter the required information.
Field Description Name The name of your MCP server.
When you type three or more characters in the Name field, duplicate detection uses fuzzy matching to identify similar existing assets, even when names differ in spelling, abbreviations, or formatting.
Type The asset type of the MCP server. The default is MCP Server.
Domain The domain in which you want to create the MCP server. The owner of the MCP server needs to have view permissions on this domain.
If you know that a certain domain exists, but it doesn't appear in the drop-down list, it could mean that:- The domain is of a type that has not been configured for this asset type. For more information, go to Assign a domain type to an asset type.
- You are subject to view permissions restrictions. By default, all users can view all assets in all communities and domains. If a community or domain is restricted by view permissions to which you are subject, the domain is not shown in the drop-down list.
Owner The Collibra users or user groups that will act as the owner of the MCP server. They are assigned the Owner resource role for the asset. By default, this is you.
URL The address of the MCP server, for example
https://mcp.example.com/mcp. This field is optional in the form, but tool discovery requires a URL. The URL must start withhttps://, orhttp://for a localhost address, and can't contain a user name or password. - Click Register.
A new asset is created in the specified domain. The MCP server appears in the registry, and is counted in the MCP servers tile.
Note Registering an MCP server in the form doesn't list its tools. To discover them, go to the next section.
Discover the tools of an MCP server
The tools of an MCP server are discovered with the Collibra CLI, not from the asset page. The CLI connects to the MCP server, retrieves its tools and their metadata, and sends them to Collibra. If the server requires authentication, the CLI runs the sign-in flow, and no credentials are stored.
Collibra creates or updates the MCP server asset, identified by its URL, and creates each tool as an AI Agent Tool asset in the groups Technology Asset section of the MCP server's asset page. If an MCP server with the same URL already exists, Collibra updates that asset instead of creating a new one. Collibra ignores a trailing slash and the letter case of the scheme and host when it compares URLs, and it never matches by name. If you don't specify a domain, the MCP server is created in the AI Models and Agents domain, and you become its Requester. The domain must allow both the MCP Server and AI Agent Tool asset types. When you discover the tools again:
- New tools are created as AI Agent Tool assets that you can classify.
- Tools that the server no longer offers are marked as not available in their metadata.
TBC - confirm how an absent tool is marked (the registration sets the available metadata key), and that the Missing from source status isn't used.
Prerequisites
- You have installed and set up the Collibra CLI.
- You know the address (URL) of the MCP server.
- You have a resource role with the Asset > Add resource permission on the domain of the MCP server. To update an MCP server that already exists, you also need the Asset > Update resource permission on the MCP server asset.
- TBC - whether the computer that runs the CLI must be able to reach the MCP server (the tools are fetched locally).
Steps
- Open your terminal or command prompt.
- Run the command to register the MCP server, with the URL of the MCP server.
TBC - the command, its options (for example a token and a domain), an example, and what the command prints on success. - If the MCP server requires authentication, the CLI starts the sign-in flow. Complete it.
The MCP server asset is created or updated in Collibra, and its tools are created as AI Agent Tool assets.
TBC - whether the CLI discovery is available in 2026.11 (DEV-228520 is still in progress). The Actions menu on the MCP Server asset page has no sync option.