> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-add-new-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Using MCP Tools

Connect external tools from [MCP servers](https://modelcontextprotocol.io/introduction) to your Dify apps. Instead of just built-in tools, you can use tools from the growing [MCP ecosystem](https://mcpservers.org/).

<Note>
  This covers using MCP tools in Dify. To publish Dify apps as MCP servers, see [here](/en/use-dify/publish/publish-mcp).
</Note>

<Info>
  Only supports MCP servers with [HTTP transport](https://modelcontextprotocol.io/docs/concepts/architecture#transport-layer) right now.
</Info>

## Adding MCP servers

Go to **Tools** → **MCP** in your workspace.

<img src="https://mintcdn.com/dify-6c0370d8-add-new-agent/44TbQ65UKzc8Aq_C/images/6cef1436fcc13a65ccedb54bcf5ab77eb87b8faba1098a85951839fb1907f2d2.png?fit=max&auto=format&n=44TbQ65UKzc8Aq_C&q=85&s=858e59901835e66d4004bb273aad9191" alt="" width="3048" height="1988" data-path="images/6cef1436fcc13a65ccedb54bcf5ab77eb87b8faba1098a85951839fb1907f2d2.png" />

Click **Add MCP Server (HTTP)**:

<img src="https://mintcdn.com/dify-6c0370d8-add-new-agent/44TbQ65UKzc8Aq_C/images/b5429131836c1caae84f4ce8b3b806221e39636723644961ce2f2a97d5421f16.png?fit=max&auto=format&n=44TbQ65UKzc8Aq_C&q=85&s=79fb02d110122dff32f0b1189e6e4a93" alt="" width="1120" height="912" data-path="images/b5429131836c1caae84f4ce8b3b806221e39636723644961ce2f2a97d5421f16.png" />

**Server URL**: Where the MCP server lives (like `https://api.notion.com/mcp`)

**Name & Icon**: Call it something useful. Dify tries to grab icons automatically.

**Server ID**: Unique identifier (lowercase, numbers, underscores, hyphens, max 24 chars)

<Warning>
  Never change the server ID once you start using it. This will break any apps that use tools from this server.
</Warning>

## What happens next

Dify automatically:

1. Connects to the server
2. Handles any OAuth stuff
3. Gets the list of available tools
4. Makes them available in your app builder

You'll see a server card once it finds tools:

<img src="https://mintcdn.com/dify-6c0370d8-add-new-agent/Lg4D_pUS5gs8ND0D/images/fcef5ecad1deca82a1d8988c4bcb7cec745a0cd47945ff05fca588502cfaafbc.png?fit=max&auto=format&n=Lg4D_pUS5gs8ND0D&q=85&s=ebf7a0aeb3e2f2a3e3b92bbb1ba9e6d4" alt="" width="1564" height="550" data-path="images/fcef5ecad1deca82a1d8988c4bcb7cec745a0cd47945ff05fca588502cfaafbc.png" />

## Managing servers

Click any server card to:

**Update Tools**: Refresh when the external service adds new tools

<img src="https://mintcdn.com/dify-6c0370d8-add-new-agent/44TbQ65UKzc8Aq_C/images/7b526a64ff34b10a357511b2cd3e42f251a6786210eac71c58ca7bfccdf63f0c.png?fit=max&auto=format&n=44TbQ65UKzc8Aq_C&q=85&s=e7113ee6bc5034cb96e50869067ff2c3" alt="" width="916" height="942" data-path="images/7b526a64ff34b10a357511b2cd3e42f251a6786210eac71c58ca7bfccdf63f0c.png" />

**Re-authorize**: Fix auth when tokens expire

**Edit Settings**: Change server details (but not the ID!)

**Remove**: Disconnect the server (this breaks apps using its tools)

## Using MCP tools

Once connected, MCP tools show up everywhere you'd expect:

**In agents**: Tools appear grouped by server ("Notion MCP » Create Page")

**In workflows**: MCP tools become available as nodes

**In agent nodes**: Same as regular agents

## Customizing tools

When you add an MCP tool, you can customize it:

<img src="https://mintcdn.com/dify-6c0370d8-add-new-agent/44TbQ65UKzc8Aq_C/images/CleanShot2025-07-07at07.41.33@2x.png?fit=max&auto=format&n=44TbQ65UKzc8Aq_C&q=85&s=ac41f0c21c6fcfd5e04ae44d58c92f4c" alt="" width="798" height="1020" data-path="images/CleanShot2025-07-07at07.41.33@2x.png" />

**Description**: Override the default description to be more specific

**Parameters**: For each tool parameter, choose:

* **Auto**: Let the AI decide the value
* **Fixed**: Set a specific value that never changes

**Example**: For a search tool, set `numResults` to 5 (fixed) but keep `query` on auto.

## Sharing apps

When you export apps that use MCP tools:

* The export includes server IDs
* To use the app elsewhere, add the same servers with identical IDs
* Document which MCP servers your app needs

## Troubleshooting

**"Unconfigured Server"**: Check the URL and re-authorize

**Missing tools**: Hit "Update Tools"

**Broken apps**: You probably changed a server ID. Add it back with the original ID.

## Tips

* Use permanent, descriptive server IDs like `github-prod` or `crm-system`
* Keep the same MCP setup across dev/staging/production
* Set fixed values for config stuff, auto for dynamic inputs
* Test MCP integrations before deploying