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

# Tools Overview

> The connectivity layer — OAuth integrations, MCP servers, and webhooks that extend what your workspace can do.

## What is the Tools module?

The Tools module is Connie's **connectivity layer**. It's where every external connection and custom integration lives — and where your workflows and AI copilot reach when they need to do something outside the product.

<CardGroup cols={2}>
  <Card title="Integrations" icon="plug">
    OAuth connections to standard SaaS — Slack, GitHub, HubSpot, Salesforce, and \~30 more. Connect once, use everywhere.
  </Card>

  <Card title="MCP servers" icon="server">
    Custom or self-hosted Model Context Protocol servers. For anything the integration catalog doesn't cover.
  </Card>

  <Card title="Webhooks" icon="bolt">
    Inbound endpoints that trigger workflows when external services emit events.
  </Card>
</CardGroup>

***

## Integrations

External SaaS connections — OAuth, token refresh, and credential storage — are managed for you. From the user's perspective:

1. Open **Tools → Integrations**, pick a provider
2. Click **Connect** → standard OAuth popup with the provider
3. The connection lands in your workspace and is immediately usable by workflows, the AI, and other modules

Connecting and disconnecting accounts happens through the in-app flow (it's an interactive OAuth handshake, not a headless API call). What the API exposes is the **catalog of available providers**, so you can see what can be connected:

```http theme={null}
GET /api/integration-providers
```

### What's in the catalog today

\~32 providers ship with Connie out of the box. The most-used:

| Category | Providers |
| - | - |
| **Comms** | Slack, Discord, Microsoft Teams |
| **Mail** | Gmail, Outlook |
| **Dev** | GitHub, Linear, Jira |
| **CRM** | HubSpot, Salesforce, Pipedrive |
| **Docs** | Notion, Google Drive, Google Sheets, Google Docs |
| **Support** | Zendesk, Intercom, Front |
| **Productivity** | Asana, ClickUp, Trello |
| **Payments** | Stripe |

Each connected account is **per-workspace** and **shared across the team** — once an admin connects a Slack workspace, every member's workflows can post to it. Members can also create their own accounts where applicable (e.g., a personal Gmail), with admin-controlled access modes per tool: `auto`, `requires_approval`, or `disabled`.

***

## MCP servers

**MCP** (Model Context Protocol) is the open standard for exposing tools and data to AI agents. Connie has full first-class support for MCP — you can attach **any** MCP-compliant server to your workspace and its tools become available to the AI brain alongside the built-in integrations.

### When to pick MCP vs an integration

| Reach for an **Integration** when… | Reach for **MCP** when… |
| - | - |
| The provider is in the Connie catalog (Slack, GitHub, Linear, etc.) | The provider isn't in the catalog |
| Standard OAuth flow is available | You need custom auth (env vars, basic auth, encrypted secrets) |
| You want zero infrastructure | You're happy hosting / pointing at a server |
| | You're exposing internal / proprietary business logic |

### Two flavors of MCP support

<CardGroup cols={2}>
  <Card title="Hosted MCP (OAuth)" icon="cloud">
    Connect to MCP servers exposed by vendors via OAuth — same UX as a catalog integration. Tools are discovered automatically.
  </Card>

  <Card title="Direct / custom MCP" icon="terminal">
    Point Connie at any HTTP MCP endpoint with custom auth — env vars, basic auth, or bearer token.
  </Card>
</CardGroup>

### Per-tool enable / disable

Once a server is connected, every tool it exposes appears in the workspace tool list. Admins can toggle individual tools on or off — the AI will only consider the enabled ones.

```http theme={null}
GET   /api/mcp-registry
GET   /api/mcp-tools/{serverId}
PATCH /api/mcp-tools/{serverId}
```

***

## Webhooks

Webhooks let external services **push** events into Connie — triggering workflows in real time. A subscription exposes an inbound endpoint that verifies the event and routes it through Connie's trigger system:

```http theme={null}
GET  /api/webhooks/{id}
POST /api/webhooks/{id}
```

Once an event arrives:

1. Its signature is verified against the subscription's secret
2. The event is parsed and routed through Connie's trigger system
3. Any workflow subscribed to that event fires with the event payload

This is the most common way to wire **"when X happens in Service Y, do Z in Connie"** automations.

***

## Common workflows

### Connect Slack and post workflow alerts

1. **Tools → Integrations → Slack** → connect
2. Build a workflow with an `on workflow failure` trigger
3. Add a Slack node, pick a channel, write your alert template
4. Save — every failure now pings the channel

### Add a custom MCP server for your internal API

1. **Tools → MCP → Add server** → choose "Direct / custom"
2. Paste your MCP endpoint URL and auth (env var or bearer token)
3. Connie discovers the tools; toggle the ones you want exposed
4. The AI copilot can now call your internal tools in any conversation

***

## API reference

<CardGroup cols={2}>
  <Card title="Integration providers" icon="grid-2" href="/api-reference/integration-providers/list-integration-providers">
    Browse the catalog of available providers.
  </Card>

  <Card title="MCP servers" icon="server" href="/api-reference/mcp-registry/list-mcp-servers">
    Add and manage Model Context Protocol servers.
  </Card>

  <Card title="MCP tools" icon="toolbox" href="/api-reference/mcp-connections/list-mcp-provider-tools">
    Discover and toggle individual tools from a connected MCP server.
  </Card>

  <Card title="Webhooks" icon="bolt" href="/api-reference/webhooks/receive-webhook">
    Inbound webhook endpoints that trigger workflows.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.