Connecting MCP Servers
Model Context Protocol (MCP) is an open standard for connecting AI systems to external tools and data sources. Adding an MCP server gives your Bourne AI agents access to any tool or capability that server exposes — whether that's querying a database, calling a third-party API, or retrieving documents from an internal system.
Adding an MCP Server
- Navigate to Settings › MCP Servers at
/app/settings/mcp. - Click Add Server.
- Enter the server URL and any required configuration values (for example, an API key or endpoint path).
- Click Save.
OAuth-Protected Servers
Some MCP servers require OAuth authorization before they can be used. When you add or use a server that requires OAuth, Bourne AI will prompt you to authorize access. Follow the on-screen steps to complete the authorization flow. Once authorized, the connection is stored so you do not need to re-authorize on each use.
Testing Your MCP Connection
After saving a new server, Bourne AI will attempt to connect and retrieve the list of tools the server exposes. You can review the available tools on the server detail page before assigning any of them to agents. If the connection fails, check the server URL and any credentials you provided, then try saving again.
Using MCP Tools Inside an Agent
Once a server is connected, its tools appear in the agent editor's tool picker alongside Bourne AI's built-in tools. Assign them to an agent the same way you would any other tool — select the tool from the picker and configure any required inputs or defaults.
Changes to tool assignments take effect the next time an agent session starts.