Aide

npx add-mcp 'https://app-api.aide.app/mcp'

At a glance

Server address	https://app-api.aide.app/mcp
Connect with	A workspace API key (Settings > Developers), or a teammate signing in with their Aide account. Claude and ChatGPT sign in; no key to copy.
Works with	Claude (web, desktop, mobile), Claude Code, ChatGPT, Perplexity including Enterprise, Gemini Enterprise, Cursor, VS Code, Devin, Docker MCP Toolkit, Vercel Connect, and clients that send an API key.
Tools	Knowledge search, Shopify order lookup and analytics; as a teammate, conversations, drafts, notes, replies, refunds, cancellations and order approvals; for owners and admins, setting up and deploying the AI agent.
Rules	The same permissions, approval rules and rate limits as the API. API keys never see conversations; refunds above your approval limit wait for an admin.
Plans	Every plan, Free included.

What an agent can do

• Search and read your knowledge, products, topics, scenarios and macros.
• Look up Shopify orders by email or order number, check return eligibility, and see order changes waiting for approval.
• Owners and admins, and API keys: read the analytics overview and satisfaction figures.
• As a teammate: find conversations with the same filters as your inbox, including one tied to a Zendesk ticket or Front conversation, and read their messages, Aide's draft, and the customer's orders and details.
• As a teammate: add an internal note, update a conversation, and reply to the customer.
• As a teammate: refund or cancel an order, and approve or reject order changes within your limits.
• Owners and admins: set Aide up from the chat. Teach Aide a website or write an article, edit and test the agent, add chat, email or a helpdesk, and deploy. A teammate who signs up from Claude or ChatGPT can send "Set up Aide for my business" and the app walks through each step, asking before anything goes live.

Connect Claude

Claude on the web, desktop and mobile. Add the Aide app in the Claude directory, then sign in. Or add it yourself as a custom connector:

1. In Claude, open Customize > Connectors and add a custom connector (Add, then Custom, then Web). On Team and Enterprise plans, an Owner adds it under Organization settings > Connectors, and each person then connects.
2. Name it Aide, paste https://app-api.aide.app/mcp and continue.
3. Under Authentication, choose Sign in now. If Claude asks how it should identify itself, choose Register automatically.
4. Claude opens Aide. Sign in, check the workspace and what Claude may do (read only, or read and act), and approve. Nothing is shared if you decline.
5. In a chat, turn Aide on from the + menu under Connectors and ask, for example, "Which open conversations are about late deliveries this week?"

More on what Claude can do with Aide: Claude customer support integration.

Connect ChatGPT

1. In ChatGPT on the web, open Plugins, select the plus button, then Add custom MCP server.
2. Name it Aide, enter https://app-api.aide.app/mcp under Connection and choose OAuth for authentication. Tick "I understand and want to continue", then select Create as a plugin.
3. Sign in to Aide and approve.
4. Install the plugin, then type @ in a chat and choose Aide. ChatGPT can also search and cite your Aide knowledge in its answers and in deep research.

On ChatGPT Business, Enterprise and Edu, workspace admins decide who may add custom MCP servers, and OpenAI lists actions that change things as a beta on those plans. More: ChatGPT customer service integration.

Perplexity and Gemini Enterprise

Perplexity, including Perplexity Enterprise, connects to https://app-api.aide.app/mcp and signs in with your Aide account, the same way Claude does. Gemini Enterprise asks for a client ID and secret instead of registering on its own: a workspace admin creates them once with Aide's registration endpoint (see For developers) and pastes them into the Gemini Enterprise console.

Claude Code, Cursor and VS Code

In Claude Code, run claude mcp add --transport http aide https://app-api.aide.app/mcp, then open /mcp and sign in to Aide in the browser. In Cursor (desktop, web and Cursor Agents) or VS Code (desktop and vscode.dev), add the server address and sign in with your Aide account, or use a read-only API key. Devin on app.devin.ai, Docker's MCP Toolkit and Vercel Connect sign in the same way.

Scripts and your own agents

Send Authorization: Bearer aide_live_… with a workspace API key from Settings > Developers. A read key reaches knowledge, products, topics, scenarios, agents, order lookup and analytics; a key with write too can also edit and publish articles. Keys act as the workspace, not a person, so they never see conversations.

Tools

Each tool is one operation of Aide's public API. Tools marked "asks first" message a customer, change an order, crawl a website or put the agent live, so the app asks you to confirm. A credential only sees the tools its role and scope allow. Every client except ChatGPT also reaches the rest of the API's settings (topics, helpdesk rules, team, billing) through a few operation tools.

Tool	What it does	Reads or acts	Who
search_knowledge	Search your knowledge base	Reads	Teammates and API keys
search	Search your knowledge, in the shape ChatGPT uses for company knowledge and deep research	Reads	Teammates and API keys
fetch	Read a knowledge document's full text, in the shape ChatGPT uses	Reads	Teammates and API keys
list_knowledge_sources	List your knowledge sources	Reads	Teammates and API keys
get_knowledge_source	Read a knowledge source, including an import in progress	Reads	Teammates and API keys
list_knowledge_documents	List knowledge documents	Reads	Teammates and API keys
get_knowledge_document	Read a knowledge document	Reads	Teammates and API keys
lookup_orders	Look up Shopify orders	Reads	Teammates and API keys
list_products	List your products	Reads	Teammates and API keys
get_product	Read a product	Reads	Teammates and API keys
list_topics	List your topics	Reads	Teammates and API keys
list_macros	List your macros	Reads	Teammates and API keys
get_macro	Read a macro	Reads	Teammates and API keys
list_agents	List your AI agents	Reads	Teammates and API keys
get_agent	Read an AI agent	Reads	Teammates and API keys
analytics_summary	Read the analytics summary	Reads	Owners, admins and API keys
analytics_overview	Read the analytics overview	Reads	Owners, admins and API keys
analytics_satisfaction	Read customer satisfaction figures	Reads	Owners, admins and API keys
render_macro	Fill in a macro for a conversation	Reads	Teammates
list_members	List your teammates	Reads	Teammates
find_conversation	Find conversations with the same filters as your inbox	Reads	Teammates
get_conversation	Read a conversation	Reads	Teammates
list_messages	Read a conversation's messages	Reads	Teammates
get_draft	Read Aide's draft for a conversation	Reads	Teammates
get_conversation_orders	Read the customer's orders on a conversation	Reads	Teammates
get_customer_context	Read the customer's details on a conversation	Reads	Teammates
check_return_eligibility	Check whether an order can be returned, from the store live	Reads	Teammates
list_conversation_order_actions	List order changes on a conversation	Reads	Teammates
list_order_actions	List order changes, including those waiting for approval	Reads	Teammates
get_setup_status	See how far setup is, and the next step	Reads	Teammates
get_chat_widget_install	Get the chat widget snippet to paste on your site	Reads	Teammates
list_agent_channels	List the inboxes an agent can answer	Reads	Teammates
test_agent	Ask the agent a question in a private preview no customer sees	Reads	Owners and admins
continue_agent_test	Send a follow-up in that private preview	Reads	Owners and admins
add_note	Add an internal note to a conversation	Acts	Teammates
update_conversation	Change a conversation's status, priority, assignee, team or on-hold reason	Acts, asks first	Teammates
reply_to_conversation	Send a reply to the customer	Acts, asks first	Teammates
refund_order	Refund an order, or request one above your limit	Acts, asks first	Teammates
cancel_order	Cancel an order, or request one above your limit	Acts, asks first	Teammates
approve_order_action	Approve an order change waiting for approval	Acts, asks first	Teammates
reject_order_action	Reject an order change waiting for approval	Acts	Teammates
update_workspace	Set the company name, website and industry	Acts	Owners and admins
add_website	Teach Aide a website or help center	Acts, asks first	Owners and admins
add_knowledge_article	Publish a knowledge article	Acts	Owners and admins
update_agent	Change an agent's instructions, greeting or signature	Acts	Owners and admins
add_support_email	Add a support email address	Acts	Owners and admins
send_forwarding_test	Send a test to check email forwarding	Acts	Owners and admins
connect_integration	Start connecting Gmail, Shopify, Zendesk, Front or Gorgias	Acts	Owners and admins
start_trial	Start a 7-day trial on a paid plan	Acts	Owners and admins
deploy_agent	Put an AI agent live for customers	Acts, asks first	Owners and admins
pause_agent	Stop an AI agent from answering	Acts	Owners and admins
set_inbox_ai	Let an agent answer an inbox	Acts, asks first	Owners and admins

What the app may do

• Read only, or read and act. You choose when you approve.
• As you, within your role. Everything is recorded as you. Agents don't see analytics or change how Aide is set up. Refunds above your approval limit wait for an admin, as they do in the inbox.
• Replies, refunds and going live ask first. Tools that message a customer, change an order, crawl a website or put the agent live are marked, so Claude and ChatGPT ask you to confirm before using them, unless you set that tool to always allow. Claude's Research can use tools without asking; connect read only if you use it.
• Disconnect any time. Settings > Developers lists connected apps and when each was last used, and Disconnect cuts an app off at once. Apps stay signed in for 30 days after they were last used; leaving the workspace disconnects them.

Your data

Aide sends the app only what the tools it calls return: a conversation's messages, an order, a knowledge article. What the app does with that is governed by the app's own terms and your settings with its maker. How Aide itself is hosted: Security.

Plans and limits

The MCP server is on every plan, including Free, and refunds, cancellations and approvals work within your role and approval limits. Up to 300 MCP messages a minute per sign-in or key. Each tool call also counts against your API limits (600 a minute per sign-in or key, 3,000 a minute per workspace), and knowledge searches share the workspace's 60 a minute.

When this is not the right fit

• You want an API key to read or answer conversations. Keys act as the workspace and never see conversations; use a teammate sign-in.
• You want to change topics, helpdesk rules, your team or billing from ChatGPT. ChatGPT gets the reviewed tool set only; use Claude, another client or the dashboard.
• You need to act on WooCommerce orders. Order lookups and actions cover Shopify.

For developers

MCP Streamable HTTP at POST /mcp: stateless, JSON responses only, for clients on protocol revision 2025-06-18 (and earlier) or 2026-07-28. OAuth 2.1: protected-resource metadata at https://app-api.aide.app/.well-known/oauth-protected-resource/mcp, authorization-server metadata at https://app-api.aide.app/.well-known/oauth-authorization-server, dynamic client registration at POST /oauth/register, authorization code with PKCE S256, scopes aide:read and aide:write, access tokens for an hour, refresh tokens that rotate and last 30 days, and RFC 7009 revocation. Redirects allowed today: the callbacks of Claude, ChatGPT, VS Code, Cursor, Perplexity, Devin, Gemini Enterprise, Docker MCP Toolkit and Vercel Connect, and http loopback. Gemini Enterprise registers a client with token_endpoint_auth_method: client_secret_post. Discovery: a server card at /mcp/server-card, an AI Catalog at /.well-known/ai-catalog.json, and the official MCP Registry entry app.aide/aide. Every tool is one operation of the public API, with the same permissions and limits.

Frequently asked questions

Which MCP server lets an AI agent read support conversations and refund orders?

Aide's. Signed in as a teammate, an MCP client can find and read conversations and Aide's drafts, reply, add notes, and refund or cancel Shopify orders, within that teammate's role. A refund or cancellation above the workspace's approval limits waits for an admin, and the agent is told it is waiting.

Can Claude reply to a customer without asking me?

Replies and order changes are marked as such, so Claude and ChatGPT ask you to confirm before using them, unless you have set that tool to always allow. Claude's Research can use tools without asking, so connect Aide read only if you use Research. A reply goes to the customer and cannot be unsent; ask for a note instead to keep something internal.

What can a workspace API key do?

A read key reaches knowledge, products, topics, scenarios, agents, Shopify order lookup and analytics. Keys act as the workspace, not a person, so they never see conversations, replies or order actions; those need a teammate sign-in.

What can a teammate with the Agent role do?

What their role allows in Aide: search knowledge, look up orders, read and answer conversations, add notes, and refund or cancel orders within their approval limit. Agents don't see analytics, and they don't change the agent, knowledge or billing. Refunds above their approval limit wait for an admin.

Does it work with Perplexity and Gemini Enterprise?

Yes. Perplexity, including Perplexity Enterprise, signs in with your Aide account. Gemini Enterprise takes a client ID and secret, which a workspace admin creates once with Aide and pastes into the Gemini Enterprise console.

How do I disconnect an app?

In Aide, open Settings > Developers. It lists the apps you have connected and when each was last used, and Disconnect cuts an app off at once. Leaving the workspace disconnects your apps too.