> ## Documentation Index
> Fetch the complete documentation index at: https://docs.budecosystem.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Configure and use your first connector in minutes

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.

```mermaid theme={null}
sequenceDiagram
  participant Admin
  participant BudAdmin
  participant budapp
  participant MCP as MCP Foundry
  Admin->>BudAdmin: Select connector and submit credentials
  BudAdmin->>budapp: POST /connectors/gateways
  budapp->>MCP: Create gateway
  MCP-->>budapp: Gateway and tool metadata
  budapp-->>BudAdmin: Configured 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.

<Note>
  Non-OAuth connectors, such as API key, headers, or open connectors, do not require an OAuth redirect.
</Note>

## 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

<CardGroup cols={2}>
  <Card title="Connector Concepts" icon="book" href="/connectors/connector-concepts">
    Understand how registry connectors, gateways, tools, scopes, and OAuth fit together.
  </Card>

  <Card title="Create Your First Connector" icon="graduation-cap" href="/connectors/creating-first-connector">
    Follow a detailed setup tutorial with validation checkpoints.
  </Card>

  <Card title="Event Connections" icon="bolt" href="/connectors/guides/event-connections">
    Configure shared trigger providers for event-driven agents.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/connectors/troubleshooting">
    Resolve common credential, OAuth, and tool attachment issues.
  </Card>
</CardGroup>