Skip to main content
Chainloop remote Model Context Protocol (MCP) server is a new way to interact with Chainloop natively from your AI clients or agents. This allows you to perform complex queries, craft compliance reports, or implement advanced agentic workflows. All of this done securely, using the data already stored and signed in Chainloop. info

How to connect to the MCP server

The MCP server is enabled by default. For self-hosted instances, use your instance’s MCP endpoint in the configurations below.
Connect your AI client to https://api.app.chainloop.dev/mcp. You can authenticate in two ways:
  • User authentication: Sign in with your Chainloop account through single sign-on (SSO). Your client opens a browser where you sign in and authorize access to Chainloop.
  • API token: Authenticate with a Chainloop API token. The token’s permissions determine what your client can access.
Follow the instructions for your client below. Select User Auth or API Token where both options are available.

Claude Code

Run the command for your authentication method:
Open Claude Code. Run /mcp. Select chainloop. Complete the browser authentication.
Example prompt:
For installation scopes and other options, see the Claude Code MCP documentation.

Codex

Run the commands for your authentication method:
Complete the browser authentication when prompted.
Open Codex. Run /mcp to check the Chainloop connection. Example prompt:
For other configuration options, see the OpenAI Docs for Codex MCP.

Cursor

Use the install button or add the configuration below to .cursor/mcp.json in your project root. For all projects, use ~/.cursor/mcp.json instead. If the file already contains MCP servers, add chainloop to the existing mcpServers object. Install MCP Server
Open Customize in Cursor’s sidebar. Enable chainloop. For User Auth, complete the browser authentication when prompted. Example prompt:
Chainloop MCP tools in Cursor

Visual Studio Code

Enable GitHub Copilot Chat. Use the install link or add the server manually with these steps:
  1. Open the Command Palette (Cmd+Shift+P on macOS or Ctrl+Shift+P on Windows/Linux). Run MCP: Add Server.
  2. Select HTTP (HTTP or Server-Sent Events). Enter https://api.app.chainloop.dev/mcp.
  3. Name the server chainloop. Choose where to save the configuration.
  4. Run MCP: List Servers. Select chainloop. Select Start Server. Complete the browser authentication when prompted.
For self-hosted instances, use your instance’s MCP endpoint. Open Copilot Chat in Agent mode. Enable the Chainloop tools. Example prompt:
For other configuration options, see the VS Code MCP documentation.

OpenCode

Add the following configuration to opencode.json in your project root. If the file already contains MCP servers, add chainloop to the existing mcp object.
Run this command. Complete the browser authentication when prompted:
Open OpenCode in your project. Example prompt:
For other configuration options, see the OpenCode MCP documentation.

Claude Desktop

Claude Desktop supports remote MCP servers through custom connectors.
  1. Open Connectors in Claude. Select Add custom connector. For Team and Enterprise plans, an organization owner must add the connector first.
  2. Name the connector Chainloop. Enter https://api.app.chainloop.dev/mcp as the remote MCP server URL.
  3. Complete the connector setup. Select Connect. Complete the browser authentication to authorize access to Chainloop.
  4. Enable the Chainloop connector from the + menu in your conversation.
Example prompt:
For API token authentication, open the connector’s Request headers. Add an Authorization header with the value Bearer <your-chainloop-api-token>. For self-hosted instances, use your instance’s MCP endpoint. It must be reachable from Anthropic’s servers. See Claude’s custom connector documentation for setup and network requirements.

Claude.ai

If you are using Claude.ai, follow the same custom connector setup as Claude Desktop. info

ChatGPT

If you are using ChatGPT, you can connect to the Chainloop MCP server by creating a custom connector that points to https://api.app.chainloop.dev/mcp.