---
title: "Managed Agents: Apps, MCP Connectors and Custom API Calls"
description: "Connect Managed Agents to outside apps with MCP connectors, add custom MCP servers, and configure custom API calls with authentication, testing and response fields."
url: https://help.aesthetixcrm.com/en/articles/2227-managed-agents-apps-mcp-connectors-and-custom-api-calls
collection: "Agent Studio"
updated: 2026-11-20
language: en
---

# Managed Agents: Apps, MCP Connectors and Custom API Calls

Connect Managed Agents to outside apps with MCP connectors, add custom MCP servers, and configure custom API calls with authentication, testing and response fields.

Managed Agents can reach beyond Aesthetix CRM through three tools: catalog MCP apps, custom MCP connectors, and custom API calls. You configure all three inside the agent under **AI Agents > Agent Studio > Managed Agents**, in the agent's **Apps** area. This guide lists every supported app, explains each setup path, and covers security and troubleshooting.

> **HIPAA caution:** AI features are not approved for processing Protected Health Information (PHI). Do not put PHI into agent instructions, files, memory, knowledge, prompts, API request bodies, or anything you send to a connected outside app. Never paste passwords, API keys or tokens into instructions; use the connector sign-in or the authentication fields described below.

## How Apps, Triggers and Instructions Fit Together

A connector only gives the agent access to outside tools. It does not decide when the agent runs or what it does. Each part of the agent has its own role:

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Part</strong></p></th><th colspan="1" rowspan="1"><p><strong>Role</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Triggers</strong></p></td><td colspan="1" rowspan="1"><p>Decide when the agent runs, for example a contact is created, an opportunity is created, or a form is submitted</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Apps</strong></p></td><td colspan="1" rowspan="1"><p>Decide which outside systems the agent may use. One agent can have several apps</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Instructions</strong></p></td><td colspan="1" rowspan="1"><p>Tell the agent when to use a tool, what data to send, which actions are allowed, when to ask for clarification, and what to do on an error or empty result</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Capabilities and Knowledge</strong></p></td><td colspan="1" rowspan="1"><p>Media generation, Knowledge Bases and other built-in tools</p></td></tr></tbody></table>

Giving an agent a connector does not mean every tool is called on every run. The agent picks tools based on its instructions and the situation.

## Supported MCP Apps

MCP stands for Model Context Protocol, a standard way for AI agents to sign in to outside applications and use the tools those applications expose. The catalog grows over time, so the tool list shown in your account is the source of truth. Available tools can vary by connector, by the connected account and its permissions, and by connector updates. Some apps need their own account, plan or permissions.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>MCP app</strong></p></th><th colspan="1" rowspan="1"><p><strong>What it lets the agent do</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>HubSpot</p></td><td colspan="1" rowspan="1"><p>Manage contacts, deals and CRM activities</p></td></tr><tr><td colspan="1" rowspan="1"><p>Notion</p></td><td colspan="1" rowspan="1"><p>Create pages, search content and organize knowledge in workspaces</p></td></tr><tr><td colspan="1" rowspan="1"><p>Apify</p></td><td colspan="1" rowspan="1"><p>Run web scraping and automation tasks with Apify actors</p></td></tr><tr><td colspan="1" rowspan="1"><p>Make</p></td><td colspan="1" rowspan="1"><p>Trigger Make scenarios and automate multi-app workflows</p></td></tr><tr><td colspan="1" rowspan="1"><p>Fathom</p></td><td colspan="1" rowspan="1"><p>Access analytics and visitor data</p></td></tr><tr><td colspan="1" rowspan="1"><p>Calendly</p></td><td colspan="1" rowspan="1"><p>Schedule meetings and manage availability</p></td></tr><tr><td colspan="1" rowspan="1"><p>Canva</p></td><td colspan="1" rowspan="1"><p>Generate and manage design assets</p></td></tr><tr><td colspan="1" rowspan="1"><p>OpenArt</p></td><td colspan="1" rowspan="1"><p>Create AI-generated artwork and visual content</p></td></tr><tr><td colspan="1" rowspan="1"><p>Monday.com</p></td><td colspan="1" rowspan="1"><p>Manage boards, create and update items, move tasks through statuses</p></td></tr><tr><td colspan="1" rowspan="1"><p>Cal.com</p></td><td colspan="1" rowspan="1"><p>Book, reschedule and manage meetings on connected calendars</p></td></tr><tr><td colspan="1" rowspan="1"><p>Higgsfield</p></td><td colspan="1" rowspan="1"><p>Generate cinematic AI videos and images from text or reference inputs</p></td></tr><tr><td colspan="1" rowspan="1"><p>GitHub</p></td><td colspan="1" rowspan="1"><p>Read code, manage issues and pull requests, trigger development actions</p></td></tr><tr><td colspan="1" rowspan="1"><p>Shippo</p></td><td colspan="1" rowspan="1"><p>Compare carrier rates, buy and print shipping labels, track shipments</p></td></tr><tr><td colspan="1" rowspan="1"><p>Windsor.ai</p></td><td colspan="1" rowspan="1"><p>Pull unified marketing and advertising data from 350+ sources and act on connected platforms, such as adjusting campaign budgets or pausing ads</p></td></tr><tr><td colspan="1" rowspan="1"><p>Vapi</p></td><td colspan="1" rowspan="1"><p>Trigger and manage AI voice calls, route calls to voice assistants, retrieve call details</p></td></tr><tr><td colspan="1" rowspan="1"><p>Google Drive</p></td><td colspan="1" rowspan="1"><p>Find, organize and manage files and folders</p></td></tr><tr><td colspan="1" rowspan="1"><p>Google Docs</p></td><td colspan="1" rowspan="1"><p>Create, read and edit documents</p></td></tr><tr><td colspan="1" rowspan="1"><p>Google Sheets</p></td><td colspan="1" rowspan="1"><p>Read and update spreadsheets, pull data, write rows, keep sheets in sync</p></td></tr><tr><td colspan="1" rowspan="1"><p>Google Slides</p></td><td colspan="1" rowspan="1"><p>Create and update presentations</p></td></tr><tr><td colspan="1" rowspan="1"><p>Google Calendar</p></td><td colspan="1" rowspan="1"><p>Create, update and look up events across connected calendars</p></td></tr><tr><td colspan="1" rowspan="1"><p>Atlassian</p></td><td colspan="1" rowspan="1"><p>Manage Jira issues, track work, read or update Jira and Confluence pages</p></td></tr><tr><td colspan="1" rowspan="1"><p>Apollo</p></td><td colspan="1" rowspan="1"><p>Search a B2B contact database, retrieve verified emails and company data, manage outreach sequences</p></td></tr><tr><td colspan="1" rowspan="1"><p>Fal</p></td><td colspan="1" rowspan="1"><p>Generate image, video and audio media with hosted AI models</p></td></tr><tr><td colspan="1" rowspan="1"><p>Zapier</p></td><td colspan="1" rowspan="1"><p>Trigger actions and automations across 8,000+ apps through a single connector</p></td></tr><tr><td colspan="1" rowspan="1"><p>Magnific</p></td><td colspan="1" rowspan="1"><p>Upscale and enhance low-resolution images</p></td></tr><tr><td colspan="1" rowspan="1"><p>DataForSEO</p></td><td colspan="1" rowspan="1"><p>Retrieve SERP results, keyword metrics and backlink data</p></td></tr><tr><td colspan="1" rowspan="1"><p>Trello</p></td><td colspan="1" rowspan="1"><p>Manage boards, create and move cards, update lists</p></td></tr><tr><td colspan="1" rowspan="1"><p>Asana</p></td><td colspan="1" rowspan="1"><p>Manage projects, create and update tasks, move work across projects</p></td></tr><tr><td colspan="1" rowspan="1"><p>ClickUp</p></td><td colspan="1" rowspan="1"><p>Create and update tasks, docs and lists</p></td></tr><tr><td colspan="1" rowspan="1"><p>Fireflies</p></td><td colspan="1" rowspan="1"><p>Access meeting transcripts, summaries and action items</p></td></tr><tr><td colspan="1" rowspan="1"><p>Kling</p></td><td colspan="1" rowspan="1"><p>Turn text prompts or reference images into short AI video clips</p></td></tr><tr><td colspan="1" rowspan="1"><p>Stripe</p></td><td colspan="1" rowspan="1"><p>Create payment links and invoices, look up customers, check transaction data</p></td></tr><tr><td colspan="1" rowspan="1"><p>Firecrawl</p></td><td colspan="1" rowspan="1"><p>Crawl and scrape websites into clean data for research and enrichment</p></td></tr><tr><td colspan="1" rowspan="1"><p>Nekt</p></td><td colspan="1" rowspan="1"><p>Connect 200+ data sources and serve unified data to agents on demand</p></td></tr><tr><td colspan="1" rowspan="1"><p>Clay</p></td><td colspan="1" rowspan="1"><p>Build and enrich lead lists from 100+ data sources, enrichment waterfalls and outbound preparation tools</p></td></tr><tr><td colspan="1" rowspan="1"><p>Lemlist</p></td><td colspan="1" rowspan="1"><p>Cold-outreach work such as lead discovery, multichannel email and LinkedIn sequences, campaign management</p></td></tr><tr><td colspan="1" rowspan="1"><p>Airtable</p></td><td colspan="1" rowspan="1"><p>Read, create and update records across Airtable tables and views</p></td></tr><tr><td colspan="1" rowspan="1"><p>Composio</p></td><td colspan="1" rowspan="1"><p>Reach 1,000+ tools through one managed gateway that handles supported authentication</p></td></tr><tr><td colspan="1" rowspan="1"><p>Reap</p></td><td colspan="1" rowspan="1"><p>Repurpose long video into short clips with captioning, dubbing and translation</p></td></tr></tbody></table>

> **Taking payments:** If you are connecting a payment tool for your practice, consider **AX Pay**, Aesthetix CRM's own payment provider, which offers better rates than Stripe. See the AX Pay Overview and Setup Guide for setup. The Stripe connector above is for agents that need to look up or create Stripe items for accounts that already use Stripe.

Example uses: enrich a new lead with Clay before routing it, create a Notion page when a consult form is submitted, add a prospect to a Lemlist campaign, or create an Airtable record after a patient-education event signup. Keep all examples to business data, not patient records.

## Connect an MCP App

1.  Go to **AI Agents > Agent Studio** and open the **Managed Agents** tab.
    
2.  Create a new agent or open an existing one. You can also tell the guided builder to add an MCP app while it builds the agent.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-Kmy2pJUYhcOhZZO69nASdSS7JSaVut9X0O1MRR9UnLnflDF2tClo9wYr0mg8GMy2W9EKtaK9GvX.png?v=1&k=us1&s=api&e=1795348800&sig=w3Bl_hOESc55GSVZ4M9_hSFn_M7GPBzDZfqANF_sjSE)
3.  In the **Apps** area, click **\+ Add app**, then browse or search the catalog and select the app (for example Notion, HubSpot or Make).
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-4Ejeats9FIbdYmJQ4mG8tEFZDmSFaKFhSLbj8atPQ6WkdjaukyrzQ2dmFQlaIUaiVdg9gYuBerQ.png?v=1&k=us1&s=api&e=1795348800&sig=Adx9ir2Nwgv6SXfGPmyvZAI1g6LQUc3DwZYnEFL9YuY)
4.  Click **\+ Connect** next to the app. Sign in using the OAuth or secure sign-in flow that appears and grant the permissions the agent needs. Use an account with only the access the agent requires.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-FSEERIj1jVCqweB8ZbDt4CdpHIKYotQZAcyCrfnzucRXpyelb0xGT53qp0l5QfzyRaKgV2eBdAD.png?v=1&k=us1&s=api&e=1795348800&sig=YrpTk_kZT2gxrszryaBbkwJwi7LhmTL6_qq8cOXw0rs)
5.  After you authenticate, the app's tool list appears. Check the boxes next to the tools the agent may use (for example `notion-create-pages` or `notion-search`). Leave unrelated tools off.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-zVoK6GVpfmq5lRHX9gmjcnJDgffhVC78Z9JKcsSHIyNZ2PDcAVQZDnz6VWMwffaTeSOG33sxmmj.png?v=1&k=us1&s=api&e=1795348800&sig=qtmKmGo4x-t9_0N8Gmo0rzWIC63ux3sXM4dLs4lYELk)
6.  Click **Save** to apply the connection and the tool selection.
    
7.  Update the agent's instructions (see below), set its trigger, click **Test Agent**, and publish when the results are correct.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-VNWUj2wT7XwQRP4sJueOglcHVhIaPj3S33x7Xz8M8SQUO6BfhSyxPo1T2AMX0PwxGdRuuGFhMnm.png?v=1&k=us1&s=api&e=1795348800&sig=gGHaJFtFRAKgNGFz8OWRwlq3GtPdfykEZ1RzmnTpu2s)

You can connect several apps to one agent; the agent chooses tools based on context and instructions. You can change tool selections at any time by editing the agent.

![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-fEfP8XXLLaZMevO006AmvyzNzzzqTfuNYU6A5w38EYyxTmNMr0aVtMk74fm8KsqokoyRtygT6SE.png?v=1&k=us1&s=api&e=1795348800&sig=hI3z6IZ_50BY_rzWc2JDAfxTG9Dd7lCW3Zzfq_nbs7w)

**What to put in the instructions**

-   Which situations require the outside app
    
-   What data the agent should read or send
    
-   Which actions it is allowed to take
    
-   When it should ask for clarification or hand off to staff
    
-   What to do when the connector returns an error or no result
    

**Testing checklist**

1.  Click **Test Agent** and use representative sample data (never real patient records).
    
2.  Confirm the correct MCP tool was called.
    
3.  Check that the expected result appears in the outside app.
    
4.  Tighten instructions or tool permissions if the agent chose the wrong action.
    

If authentication fails later or access is revoked, the agent cannot act in that app. Reconnect it from the **Apps** area to re-authenticate.

## Custom MCP Connectors

If the app you need is not in the catalog, add any compatible MCP server, either a third-party server or your own internal one. You need a server name (a descriptive label) and the server URL where it is hosted. If the server requires authentication, you also need the credentials from the server provider.

1.  In Agent Studio, open the Managed Agent and go to the **Apps** area.
    
2.  Click the option to add an MCP app, then click **\+ Add custom MCP**.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-p1Ap9vJ1bn11fsVDomsr2TxpY24dHFLngdzGKMYB7dydgVLVBtO6BK8fTJfoWe3QkukqV11dnIp.png?v=1&k=us1&s=api&e=1795348800&sig=QUzafEGEqFqF6i_0wAfDFio5yQvP_gOGZhxoOUli7EE)
3.  Enter a descriptive **Server name** and the **Server URL**.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-5ffRp5XRVRuB5ZTU74pAAebnvRRDOM9MNmLXXd1rVBtkYgucP68fAJqMrhQW9Pn6T7m7cRjlc8e.png?v=1&k=us1&s=api&e=1795348800&sig=jeviRL15-naHkHznPA7OohmBSZWF6kpTbgK0Qc0UNGg)
4.  Click **Add MCP** to save the connector.
    
5.  Wire the connector to your agent so it can use the server's tools, then select which tools the agent may use.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-oIBbeNdfwfJlSNHaBrEoac1HvCXCfhRHLb9t4yfDsjgknkbgBzd9AYw07RprbCL1YPCqeqXFozl.png?v=1&k=us1&s=api&e=1795348800&sig=5FDR8AsE90EnqpAmF71_z057j8GiL1BJd1B5wf7IgVM)

**Authentication for custom MCP servers**

1.  When adding or editing the connector, open **Advanced settings**.
    
2.  Enter the **Client ID** issued by your MCP server provider.
    
3.  Enter the **Client Secret** issued by the provider. This field is encrypted.
    

Only configure credentials if the server requires them. Many do not. Check the server's documentation.

You can add several custom connectors to one agent. There is no fixed limit, but too many tools can slow the agent and make its choices less accurate, so keep only what the use case needs. You can edit or remove a custom connector at any time, and changes take effect immediately.

### Authentication and transport options for MCP connections

When an MCP connection is set up from the AI Agent action in a workflow (the connection form with Test Connection), these options are available:

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Setting</strong></p></th><th colspan="1" rowspan="1"><p><strong>Options</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Authentication type</strong></p></td><td colspan="1" rowspan="1"><p>None, API Key, Bearer Token, OAuth2, Custom Header</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Transport type</strong></p></td><td colspan="1" rowspan="1"><p>HTTP Streamable (default and recommended), Server-Sent Events (SSE)</p></td></tr></tbody></table>

Some providers expect an API key in an HTTP header and others as a query parameter. Follow your provider's documentation. Use HTTP Streamable unless the provider says otherwise.

![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-APcLgMKO434pCJC3rv6emRsiHHwgqwXJilc6AM22AZrwkDGfY1O0LUObuxDE1GlDcFMHlOF0XCv.png?v=1&k=us1&s=api&e=1795348800&sig=fRiXmKJIf4kQUv40cEibzKwpGPkSKp55_ip8CoCofVQ)

**Test Connection** verifies communication with the server, validates the credentials, discovers the tools the server offers and lists every tool it returns. After discovery, enable only the tools the AI agent should use and save. Tool permissions apply per AI agent, so different agents can use different tool sets from the same server.

![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-sPQdfAAmytsCmnrF2djNFf2plTZDILPs44p2o8kgU526wuHCSaqLl97rgtYH2nz1m5DGIf6ciKj.png?v=1&k=us1&s=api&e=1795348800&sig=cNCrYwT6paFCNN6oQ_34IiFi4ketftJfPxLcSfQyXA0)

Common examples of MCP servers are Exa (web search across companies, people and news), Tavily (real-time web search and page extraction), Browserbase (browser automation) and self-hosted servers that follow the MCP specification. Aesthetix CRM does not host or manage third-party MCP servers; their availability, pricing, authentication and tools are set by the provider, and they may need their own account or usage fees.

## Custom API Calls

Custom API Calls let a Managed Agent call an external API during a conversation to read live information, send data or check availability. When the call is relevant, the agent checks whether it has the required values, asks for any that are missing, sends the configured request with your authentication, and uses the response fields you selected to continue.

**Before you start**, have the API documentation and credentials ready: endpoint, method, required parameters, headers, body fields and which response data the agent needs.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Option</strong></p></th><th colspan="1" rowspan="1"><p><strong>Supported values</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Request methods</strong></p></td><td colspan="1" rowspan="1"><p>GET, POST, PUT, PATCH, DELETE</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Authentication</strong></p></td><td colspan="1" rowspan="1"><p>API Key, Bearer Token, Basic Authentication, No Authentication</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Request details you can configure</strong></p></td><td colspan="1" rowspan="1"><p>Method, endpoint URL, path or query parameters, headers, request body (when required), authentication, usage instructions</p></td></tr></tbody></table>

**Set up a Custom API Call**

1.  Go to **AI Agents > Agent Studio**, open **Managed Agents**, and select the agent.
    
2.  Add or configure the Custom API Call and enter the request method, endpoint URL, parameters, headers, body and authentication.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-mbrV5xCH9wJEGvdkaFPqDMCzT8t1krojByAw2FdAtwsfP4AnE6MRZNiLQkurJ8zNixGuyoKJtJx.png?v=1&k=us1&s=api&e=1795348800&sig=jMPYJhhC3X-UCzpfcLtod6Tq9XDpAXZ_GJOWqA06LZY)
3.  Write clear instructions describing **when the agent should use this API**. This matters most when the agent has several tools or API calls.
    
4.  Test the request: enter test values for the required parameters, run it, and review the status and response. The test view can show a cURL preview for reference or troubleshooting. You do not need to write cURL yourself.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-P5PjqAxRCVI2ApjXsqJpm94WDYOF7YtalkaYKARLv79kDdqJI23s5HicJfIgwAKEqcz2QkJHy6V.png?v=1&k=us1&s=api&e=1795348800&sig=n07_YsUBh1UXYTctrWlX-eE5j-Fea2tCMCFJ0oES0iA)
5.  Select the **response fields** the agent should use. Include only the data it needs.
    
6.  Save, then test the whole agent with realistic requests. Confirm the right API is chosen, required values are collected, the request succeeds and the expected response data is used, before you publish.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-nog8H6NNiqr8Keb8wRPVaEUSMA6dRpyZTKjZclXSrYgJ98yXhXJG6IGppBnWgf40nyFgfTOtWSv.png?v=1&k=us1&s=api&e=1795348800&sig=qvAUuCo_wgc-hWp_ltwUx5HlLqjT2YsAwX8HWLekdQ8)

You can configure multiple API calls on one agent. Give each its own usage instructions.

## MCP in Ask AI vs Managed Agents

Managed Agents and Ask AI can both use MCP connectors, but they work differently.

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Area</strong></p></th><th colspan="1" rowspan="1"><p><strong>Managed Agents</strong></p></th><th colspan="1" rowspan="1"><p><strong>Ask AI</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>How work starts</p></td><td colspan="1" rowspan="1"><p>A configured trigger or supported agent event</p></td><td colspan="1" rowspan="1"><p>You ask Ask AI to do a task</p></td></tr><tr><td colspan="1" rowspan="1"><p>Where you configure connectors</p></td><td colspan="1" rowspan="1"><p>The agent's <strong>Apps</strong> area</p></td><td colspan="1" rowspan="1"><p>In Ask AI: <strong>Customize &gt; Connectors &gt; Manage Connectors</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p>Typical use</p></td><td colspan="1" rowspan="1"><p>Repeatable, event-driven automation</p></td><td colspan="1" rowspan="1"><p>Interactive, user-started work</p></td></tr><tr><td colspan="1" rowspan="1"><p>Tool control</p></td><td colspan="1" rowspan="1"><p>Select the connector's tools for the agent</p></td><td colspan="1" rowspan="1"><p>Enable the connector and control which tools are allowed</p></td></tr></tbody></table>

To connect an app in Ask AI: open **Ask AI**, go to **Customize > Connectors**, select **Manage Connectors**, find the app, connect and authenticate the account, review and enable the tools Ask AI may use, enable the connector, then start a chat that asks for something needing the app. MCP connectors are not yet available for Conversational AI or Voice AI.

AI agents inside workflows (the AI Agent workflow action) have their own MCP connection form: open the workflow, add or edit the AI Agent action, choose **Add Tools**, open the **MCP** tab and click **Add Connection**. It uses the same authentication and transport options listed above.

![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-8ND6dBPzQny06GHYMLo8OJdAJg6q5IXvMZT8fYDaAA9dJgSpjZhie84E3ZpKexJ4rZkSG8l82xl.png?v=1&k=us1&s=api&e=1795348800&sig=qZEOL-pCLaLYtmSgKhcOGJlqQdY4Qom9Zrnh4qWSTG8)

## Security and Access Best Practices and Troubleshooting

-   Grant only the minimum permissions in the outside account.
    
-   Select only the tools the agent needs.
    
-   Keep credentials out of prompts. Use the sign-in flow or the authentication fields.
    
-   Write explicit guardrails: what the agent may do and when it must confirm or escalate.
    
-   Test read and write actions with realistic non-patient data before turning on live triggers.
    
-   Connect only trusted providers, give connections descriptive names and rotate credentials on your own security schedule.
    
-   Review tool lists after connector updates and review permissions periodically.
    
-   Do not send PHI to outside apps. Many third-party services are not set up for PHI.
    

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Issue</strong></p></th><th colspan="1" rowspan="1"><p><strong>What to check</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>App connected but the agent cannot use it</p></td><td colspan="1" rowspan="1"><p>Confirm the app is attached to the correct agent and the individual tools are enabled</p></td></tr><tr><td colspan="1" rowspan="1"><p>Authentication fails</p></td><td colspan="1" rowspan="1"><p>Reconnect, verify the outside account, and confirm that account can authorize the requested access</p></td></tr><tr><td colspan="1" rowspan="1"><p>A tool does not appear</p></td><td colspan="1" rowspan="1"><p>Review the connector's current tool list and the plan or permissions on the outside account</p></td></tr><tr><td colspan="1" rowspan="1"><p>The agent uses the wrong action</p></td><td colspan="1" rowspan="1"><p>Reduce tool access and make the instructions more explicit about when to use each tool</p></td></tr><tr><td colspan="1" rowspan="1"><p>The agent does not run</p></td><td colspan="1" rowspan="1"><p>Check the trigger is configured, the agent is published, and your test event matches the trigger</p></td></tr><tr><td colspan="1" rowspan="1"><p>It worked before but now fails</p></td><td colspan="1" rowspan="1"><p>Authorization may have expired or been revoked; reconnect and retest</p></td></tr><tr><td colspan="1" rowspan="1"><p>Test Connection fails (workflow connections)</p></td><td colspan="1" rowspan="1"><p>Check the server URL, authentication settings, credentials and transport type, and that the server is online</p></td></tr><tr><td colspan="1" rowspan="1"><p>Ask AI does not use the connector</p></td><td colspan="1" rowspan="1"><p>Confirm the connector and tool are enabled and your request clearly needs the connected app</p></td></tr></tbody></table>

## Frequently Asked Questions

**What is the Model Context Protocol (MCP)?**

MCP is a standard that lets AI agents sign in to outside applications and use their tools safely. It defines how an agent authenticates, discovers tools and runs actions.

**Can one Managed Agent use more than one app?**

Yes. Attach as many apps as the job needs and make the instructions clear about when to use each one.

**Does adding an app make the agent run automatically?**

No. The connector only supplies tools. The agent still needs a trigger and instructions to know when to run and what to do.

**Are my credentials safe?**

Connectors use OAuth or secure sign-in flows, and the agent receives only the permissions you grant. Client secrets for custom servers are encrypted. Never type passwords or keys into the agent's instructions.

**What is the difference between catalog apps and custom connectors?**

Catalog apps are prebuilt integrations you pick from the list. Custom connectors let you add any compatible MCP server by name and URL.

**How do I limit what an agent can do in an app?**

After connecting, check only the tools you want. You can change the selection any time by editing the agent.

**Do I need an account with the outside app?**

Usually yes. You sign in to an eligible account, and plans or permissions can vary by app.

**Which authentication methods work for Custom API Calls?**

API Key, Bearer Token, Basic Authentication, or no authentication.

**What if the API needs a value the contact has not given?**

The agent asks for the missing value during the conversation before sending the request.

**Can I send patient information to a connected app or API?**

No. AI features are not approved for PHI, and outside apps may not be set up to handle it. Use only non-identifying business data.
