# Manage integrations (/en/ai/studio/build/integrations)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

Use Integrations to centrally manage knowledge bases, MCP servers, custom tools, and connectors, and use Model Credentials to manage your AI provider API keys. Store a resource once, then attach it to any agent in the same project.

## Credentials

To save your credentials for a vendor:

1. In the navigation sidebar, select **Model Credentials**.
2. Select **Create Credential**.
   ![Add credential dialog](https://assets-docs.agora.io/images/console/create-credential.png)
3. Enter a descriptive **Name** for your credential.
4. From the **Type** dropdown, select **ASR/STT**, **LLM**, **TTS**, or **MLLM**.
5. Select the **Vendor** from the dropdown for which you want to add the credential.
6. Paste your provider's API **Key** and complete any other required fields, such as **Region**, which vary by vendor.
7. Select **Create**.

After you add a credential, you can select it from the **Credentials** dropdown when customizing your ASR, LLM, TTS, or MLLM configuration for any agent.

You can edit and delete credentials using the **Action** menu in the credential list.

<CalloutContainer type="warning">
  <CalloutTitle>
    Caution
  </CalloutTitle>

  <CalloutDescription>
    Deleting a credential affects all agents that use it. Verify that no active agents depend on the credential before deleting, or update those agents to use a different credential first.
  </CalloutDescription>
</CalloutContainer>

### Credential security

Credentials stored in Model Credentials are:

* Encrypted and securely stored in your Agora account
* Only accessible to users with access to your Agora project
* Never exposed in agent configurations or logs

<CalloutContainer type="success">
  <CalloutTitle>
    Best practices
  </CalloutTitle>

  <CalloutDescription>
    * Use descriptive names to distinguish between development, staging, and production credentials.
    * Rotate API keys regularly according to your security policies.
    * Delete unused credentials to minimize security exposure.
  </CalloutDescription>
</CalloutContainer>

## Knowledge bases

A knowledge base provides your agent with additional context by supplying reference documents that the agent can draw on during conversations. Once created, knowledge bases can be attached to any agent from the **Actions** panel.

To create a knowledge base:

1. In the navigation sidebar, select **Integrations**.
2. At the top of the page, select **Knowledge Bases**.
3. Select **Create Knowledge Base**.
   ![Create knowledge base dialog](https://assets-docs.agora.io/images/console/create-knowledge-base.png)
4. Enter a **Knowledge Base Name** and **Description**.
5. Upload one or more files by selecting **Choose files**.
6. Select **Create**.

<CalloutContainer type="info">
  <CalloutTitle>
    Info
  </CalloutTitle>

  <CalloutDescription>
    Supported file formats: PDF, DOCX. Maximum file size: 20 MB per file.
  </CalloutDescription>
</CalloutContainer>

You can edit or delete knowledge bases using the **Action** menu in the knowledge base list.

## MCP servers

MCP (Model Context Protocol) servers extend your agent's capabilities by enabling it to call tools provided by external services. Once added to Integrations, MCP servers can be attached to any agent from the **Actions** panel.

To add an MCP server:

1. In the navigation sidebar, select **Integrations**.
2. At the top of the page, select **MCPs**.
3. Select **Create MCP Server**.
   ![Add MCP server dialog](https://assets-docs.agora.io/images/console/create-mcp.png)
4. Enter a descriptive **Name** for the MCP server.
5. Enter the **Endpoint** URL.
6. Set the server **Protocol** to **SSE** or **HTTP**.
7. Set the &#x2A;*Timeout (ms)**. If the server does not respond within this duration, the agent stops waiting and continues executing.
8. Add **HTTP Headers** for authentication or additional configuration. Optional.
9. Add **Query Parameters** to append to the server URL. Optional.
10. Select **Create**.

You can edit, delete, or check the status of an MCP server using the **Action** menu in the MCP server list.

## Custom tools

Custom tools let you define reusable HTTP tools for your agents.

To create a custom tool:

1. In the navigation sidebar, select **Integrations**.
2. At the top of the page, select **Custom Tools**.
3. Select **Add Custom Tool**.
   ![Add custom tool dialog](https://assets-docs.agora.io/images/console/new-custom-tool.png)
4. Configure the request, function schema, and optional body template. See [Custom tools](custom-tools) for detailed setup guidance.
5. Save the tool.

After you create a custom tool, attach it to an agent from the agent editor **Actions** tab.

## Connectors

Connectors provide built-in integrations that agents can use without requiring you to build your own HTTP or MCP layer.

Currently available:

* [HubSpot Connector](hubspot-connector): Connect HubSpot and attach it to agents that need contact and ticket workflows

After you connect, attach the connector to an agent from the agent editor **Actions** tab.