Skip to main content

Connect an MCP Server

Add an external Model Context Protocol (MCP) server to your organization. MCP servers expose tools that your agents can use during workflow execution.

Prerequisites​

  • A running MCP server accessible via HTTP
  • Any credentials the server requires (see Add a Credential)

Steps​

1. Navigate to MCP Servers​

Open the sidebar and click Settings, then MCP Servers. You see a grid of MCP server cards for any servers already connected.

MCP Servers settings page

2. Click "New MCP Server"​

Click the New MCP Server button or card. A new server card appears, or you are taken to the creation form.

3. Enter the server name​

Give the server a descriptive name (e.g., "Brave Search", "GitHub Tools", "Sentry"). This name appears in the UI when browsing available tools.

4. Enter the server URL​

Provide the full URL where the MCP server is reachable. This is the HTTP endpoint that implements the MCP protocol.

https://mcp.example.com
http://localhost:8080
info

The URL must be reachable from the ORQO server at connection time and from the engine at workflow execution time. For local development, use localhost or Docker service names.

5. Assign credentials (if required)​

If the MCP server requires authentication, assign the appropriate credential from the credential selector. The credential is passed to the server during tool discovery and execution.

6. Save and verify the connection​

Click Save. ORQO connects to the server and attempts to discover its available tools via the MCP protocol. If the connection succeeds:

  • The server card shows a verified status
  • Discovered tools appear as a list on the server card

If the connection fails, the card shows an error status with details about what went wrong (network error, authentication failure, protocol mismatch).

7. Review discovered tools​

After a successful connection, expand the server card to see all discovered MCP tools. Each tool shows:

  • Name -- The tool's identifier (used in agent configurations)
  • Description -- What the tool does

These tools become available for assignment to agents via skills or direct tool configuration.

tip

MCP tools are automatically available in the tool library after discovery. You can assign them to skills or directly to agents just like built-in tools.

8. Update or reconnect​

If the MCP server's tool set changes (new tools added, tools removed), click the server card and trigger a re-discovery. ORQO refreshes the tool list from the server.

9. Delete an MCP server​

Click the server card and then Delete. This removes the server and all its discovered tools from your organization. Any skills or agents referencing these tools will lose access to them.

What's next​

Learn more​