Quick Start

This guide walks through creating a reusable MCP connection from the connector registry and attaching tools from that connection to an agent.

​

Step 1: Open Connectors

1. Log in to Bud AI Foundry.
2. Click Connectors in the left sidebar.
3. Stay on the Connectors tab to browse registry connectors.

​

Step 2: Choose a Connector

1. Use search to filter the registry.
2. Open the connector card you want to configure.
3. Review the connector metadata, authentication type, and tags.

​

Step 3: Add a Connection

1. Click Add Connection.
2. Select connection type (MCP Server or API).
3. Enter the connector credentials.
4. Choose the agent visibility scope:
   • Global: available to all projects.
   • Projects: available only to selected projects.
5. Save the connection.

​

Step 4: Authorize When Needed

OAuth connectors require a user authorization step before tools can be fetched.

1. Open the connection from an agent’s Connections panel.
2. Click Connect or Authorize.
3. Complete the provider consent screen.
4. Return to Bud Admin after the OAuth callback completes.

​

Step 5: Attach Tools to an Agent

1. Open an agent builder or edit screen.
2. Open Connections.
3. Expand the connection.
4. Select the tools the agent should be allowed to use.
5. Click Add to agent.

Bud stores the gateway reference and selected tool IDs in the prompt configuration. Reopening the agent shows already attached tools as selected.

​

Step 6: Manage the Connection

Use the Connections tab on the Connectors page to:

• Enable or disable a configured connector.
• Update client and agent visibility tags.
• Rename or inspect gateway details.
• Delete connections that should no longer be used.

​

Next Steps