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

# MCP Connections

> Connect external tool servers to the Pastures AI crew via Model Context Protocol.

MCP (Model Context Protocol) connections let the Pastures AI crew interact with external tool servers — ticketing systems, incident management platforms, and other operational tools.

## What are MCP connections?

MCP is an open protocol that allows AI agents to discover and call tools provided by external servers. In Pastures, this means the AI diagnostics crew can:

* Create tickets in Jira when diagnosing issues
* Trigger PagerDuty incidents for critical findings
* Query external systems for additional context during diagnostics

## Configure connections

Navigate to **Pastures → Settings → AI Crew Connections**.

Each connection requires:

| Field       | Description                                                 |
| ----------- | ----------------------------------------------------------- |
| Name        | A display name for the connection (e.g., "Production Jira") |
| URL         | The MCP server endpoint                                     |
| Auth Type   | `none`, `basic`, or `bearer`                                |
| Credentials | Username/password for basic auth, or token for bearer auth  |

<Steps>
  <Step title="Add a connection">
    Click **Add Connection** in the AI Crew Connections section.
  </Step>

  <Step title="Fill in the fields">
    Enter the connection name, MCP server URL, and authentication details.
  </Step>

  <Step title="Test the connection">
    Click **Test Connection** to verify the MCP server is reachable and authentication is valid.
  </Step>

  <Step title="Save">
    Click **Save**. The connection is now available to the AI crew during diagnostic sessions.
  </Step>
</Steps>

## Demo mode connections

When [demo mode](/configuration/demo-mode) is enabled, two sample MCP connections are pre-configured:

| Name      | Type                | Purpose                                      |
| --------- | ------------------- | -------------------------------------------- |
| Jira      | Ticketing           | Create and update issues from AI diagnostics |
| PagerDuty | Incident management | Trigger and resolve incidents                |

These demonstrate the MCP integration workflow without requiring live external services.

<Tip>
  MCP connections are optional. AI diagnostics work fully without any external tool servers configured.
</Tip>