Skip to main content
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 connectors… to filter the registry.
  2. Open the connector card you want to configure.
  3. Review the connector metadata, authentication type, tags, and documentation link.

Step 3: Add a Connection

  1. Click Add Connection.
  2. Enter the connector credentials requested by the credential schema.
  3. Choose the agent visibility scope:
    • Global: available to all projects.
    • Projects: available only to selected projects.
  4. 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.
Non-OAuth connectors, such as API key, headers, or open connectors, do not require an OAuth redirect.

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

Connector Concepts

Understand how registry connectors, gateways, tools, scopes, and OAuth fit together.

Create Your First Connector

Follow a detailed setup tutorial with validation checkpoints.

Event Connections

Configure shared trigger providers for event-driven agents.

Troubleshooting

Resolve common credential, OAuth, and tool attachment issues.