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

# Model Context Protocol

Model Context Protocol (MCP) is an open standard that lets AI agents interact with external tools and services through a single, consistent interface. Instead of building a custom integration for each tool, agents can connect to MCP servers and access all the tools they expose via a single standardized protocol. [Learn more](https://modelcontextprotocol.io/docs/getting-started/intro).

| Without MCP                                                                                                                                                                                               | With MCP                                                                                                                                |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Connecting to multiple external services requires a separate integration with custom logic for each service, resulting in maintenance overhead whenever changes are made to the APIs / external services. | The agent accesses multiple tools through a single standardized interface, reducing integration effort and simplifying tool management. |

## Prerequisites

Before you configure an MCP server, ensure that you have:

* The MCP server endpoint URL.
* The required authentication credentials.
* Any request headers required by the MCP server.

## Manage MCP Servers

Use the MCP Servers page to add, edit, view, and delete MCP servers, and to manage the tools available for each server.

After updating the MCP server configuration on the platform, reconfigure the server to validate the changes and refresh the available tools.

You can't delete an MCP server or tool are in use. If dependencies exist, the platform displays where the server or tool is used and prompts you to remove those references before deleting it.

<Note>In **Development** mode, the app displays all configured tools. In **Published** mode, the app displays only the tools selected in the Agent Node.</Note>

To configure an MCP server:

1. Go to **Generative AI Tools** > **MCP** and click **+ New MCP Server**.

   <img src="https://mintcdn.com/koreai/EXZVrjEfrdiRcBLq/ai-for-service/generative-ai-tools/images/configure-mcp-server.png?fit=max&auto=format&n=EXZVrjEfrdiRcBLq&q=85&s=64a8ff168baaa65aca0d4478fdc3a133" alt="Configure MCP Server" width="618" height="611" data-path="ai-for-service/generative-ai-tools/images/configure-mcp-server.png" />

2. Enter the **Name** and **Description**.

3. Enter the MCP server endpoint URL.

4. Configure the required request headers. Click **+ Add** to add a header and specify the key and value. Use environment variables where appropriate.

5. Select the authentication type.
   <Note>MCP supports server-level authentication only, such as API keys and OAuth 2.0 Client Credentials. User-based authentication is not supported.</Note>

6. Click **Configure**.

7. Verify the connection and click **Proceed**.

   <img src="https://mintcdn.com/koreai/EXZVrjEfrdiRcBLq/ai-for-service/generative-ai-tools/images/mcp-auth-success.png?fit=max&auto=format&n=EXZVrjEfrdiRcBLq&q=85&s=d8334e4556242a0774de34c3e21cafde" alt="Authentication Successful" width="530" height="182" data-path="ai-for-service/generative-ai-tools/images/mcp-auth-success.png" />

8. Select the tools that you want to use and click **Add Tools**.

   <img src="https://mintcdn.com/koreai/EXZVrjEfrdiRcBLq/ai-for-service/generative-ai-tools/images/mcp-select-tools.png?fit=max&auto=format&n=EXZVrjEfrdiRcBLq&q=85&s=5df0196f30532a225ae09d6a8b187b73" alt="Select MCP Tools" width="1174" height="638" data-path="ai-for-service/generative-ai-tools/images/mcp-select-tools.png" />

9. Verify that the selected tools appear on the **MCP** page.

   <img src="https://mintcdn.com/koreai/EXZVrjEfrdiRcBLq/ai-for-service/generative-ai-tools/images/mcp-tools-list.png?fit=max&auto=format&n=EXZVrjEfrdiRcBLq&q=85&s=392622089b16d79a8c5a18f6762ac0ce" alt="MCP Tools List" width="958" height="344" data-path="ai-for-service/generative-ai-tools/images/mcp-tools-list.png" />

10. In the **Agent Node**, select one or more MCP tools to make them available to the AI Agent.

<Note> If you update an MCP server configuration, reconfigure the server to validate the changes and refresh the available tools.</Note>

## Debug Logs

The platform records detailed logs for every MCP server and tool execution. Logs include request and response details, execution status, latency, runtime activity, and entity updates. MCP activity is also available in Task Execution Logs, including the associated MCP server and tool information. Sensitive values are automatically masked.

## Best Practices

* Reconfigure an MCP server after making changes to refresh the available tools and metadata. The platform doesn't automatically detect server updates.
* Use environment variables for API keys, tokens, and other sensitive values instead of hard-coding them in headers.
* After importing an app into another environment, verify that the required authentication profiles, environment variables, and credentials are configured correctly.
* Use clear and unique tool descriptions to help the AI Agent select the appropriate tool during execution.
