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

# MCP Tool Connectors

> Configure MCP gateways and attach selected tools to agents

## Overview

MCP tool connectors expose external capabilities to Bud agents through configured gateways. The recommended pattern is to create a reusable gateway once, authorize it if needed, and attach only approved tools to each agent.

## Recommended Workflow

```mermaid theme={null}
flowchart LR
  A[Admin configures gateway] --> B[Gateway appears as available connection]
  B --> C{OAuth required?}
  C -->|Yes| D[User authorizes]
  C -->|No| E[Fetch tools]
  D --> E
  E --> F[Select tool IDs]
  F --> G[Attach to agent]
```

## Scope Connections Deliberately

Use narrow scopes for sensitive systems. Start with the current project, verify the tool behavior, then expand to more projects or global access only when the connection is ready for reuse.

## Attach the Minimum Tool Set

Agents should receive the smallest set of tools required for the task. This makes tool choice easier to audit and reduces accidental actions.

## Updating an Agent's Tools

Reopen the connection from the agent builder, change the selected tools, and click **Add to agent** again. The attach operation replaces the selected tool set for that gateway on that agent.

## Detaching Tools

Use **Remove** or **Disconnect** in the agent connection panel to detach the gateway from a single agent. The shared gateway remains available to other agents and projects.