Connect Your A.I. App to Your Portal (MCP)

What is MCP?

MCP (Model Context Protocol) is the standard way A.I. apps such as Claude and ChatGPT connect to other software. Your portal has its own MCP address. Add that address to your A.I. app, sign in, click Allow, and the app can work in your portal for you: look up a Contact, start a Project, raise a Task, draft an Invoice, log time or run a report, just by asking in plain words.

The app works as you. It can only see and do what you can see and do in this portal, with your own role's permissions. Apart from a few staff-only records it creates, it asks you to confirm before it changes anything (see "Does the app ask before it changes something?" below).

There is no API key to copy. You sign in with your normal portal login.

IMPORTANT: Your account needs the A.I. Service or an active A.I. Connection of your own. Without one, your A.I. app still connects but sees no Tools. A new free trial already includes the A.I. Service's free monthly tier, so it is ready.

For the full technical reference (addresses, sign-in, every Tool), see the SuiteDash MCP connector page.


Who can connect?

  • Staff only. Clients and Prospects cannot connect an A.I. app.
  • The Super Admin can always connect, with every Tool and Skill, and this cannot be switched off.
  • Other Staff roles start switched off. An administrator turns MCP Access on for a role, or for one person, in A.I. Studio > MCP Access (see "Turn on MCP Access for your team" below).

Where do I find my MCP address?

  1. Go to My Account > Connections.
  2. Find the Connected A.I. Apps card. It shows the connection steps, your MCP Address with a Copy button, and a Setup Prompt for coding assistants.

The card only appears once MCP Access is on for you.

Your address is your portal's own web address followed by /mcp, for example https://portal.yourbusiness.com/mcp.

If your account does not have its own domain yet, the card shows a shared address instead, and it works the same way.

TIP: Set up your Custom URL before you connect. Changing your portal's address later disconnects every A.I. app connected to it, and each one has to be connected again at the new address.


How do I connect Claude, ChatGPT or another A.I. app?

The steps are the same for any A.I. app that supports MCP, and they are printed on your Connected A.I. Apps card:

  1. Check that your account has the A.I. Service or an active A.I. Connection. Without one, the app connects but sees no Tools.
  2. Open your A.I. app's settings and add a custom connector (some apps call it an MCP server).
  3. Name it after your portal and paste your MCP Address.
  4. Click Connect, sign in with your portal login, and click Allow.

When you click Connect, your portal opens a page headed "[App name] wants to connect to [your portal]". It tells you the app will use your permissions and the Tools enabled for you. Click Allow, and the app sends you back. You are connected.

Claude: add your MCP Address as a custom connector in Claude's settings, then click Connect and sign in.

ChatGPT: add your MCP Address as a custom connector (ChatGPT may call it an app or a connector) in ChatGPT's settings, then sign in. Which ChatGPT plans allow custom connectors, and whether they can make changes or only read, is decided by ChatGPT; see ChatGPT's own help.

A coding assistant (such as Claude Code, Codex or Cursor): copy the Setup Prompt from the card and paste it into the assistant. It reads: "Add a remote MCP server named [your portal] using HTTP at [your MCP Address], then tell me how to sign in to it with my portal login."

IMPORTANT: Use the address from your own Connected A.I. Apps card. An address belonging to another account will not connect, even if you can sign in there.

TIP: You cannot approve an app while you are impersonating someone. Stop impersonating first.


What can my A.I. app do?

Your app gets about 160 Tools, each one doing what a screen in your portal does, and each one answering to your role in exactly the same way.

Area What the app can do
CRM Find, read, create, update and delete Contacts, Companies and Notes; add or remove Tags; manage Circles; link a Contact to a Company; convert a Contact's Role; set Follow-ups; send a Portal Access Invitation.
Projects and Tasks Find, read, create, update, archive and delete Projects and Tasks; apply a Project Template; add subtasks and comments; handle Work Requests.
Office Find and read Invoices, Estimates, Proposals, Payments and Subscriptions; create and update Invoice drafts, Estimates and Proposals; add Items; record a payment; track Expenses.
Deals Find, create, update, move, close and reopen Deals, and read the Deal forecast.
Time tracking Start, pause and finish timers, log time and bill it.
Staff and Teams Find and read colleagues and Teams, add or update a Staff member, and manage Teams.
Reports Run reports such as Sales Pipeline, Invoice Status, Payments Received, Profit and Loss, Timesheets and Overdue Tasks.
Skills List the Skills enabled for you and run one through an Agent.

Some Tools also need your plan to include that feature. For example, the Proposal Tools need Proposals and the Deal Tools need Deals.


Does the app ask before it changes something?

  • Finding and reading never ask. They change nothing.
  • Five creates run without asking, because what they make is visible only to your staff: a draft Invoice, a draft Estimate, a draft Proposal, an Expense and a Circle. No Client sees them until someone on your team acts on them.
  • Every other create, change or delete asks you first. Your A.I. app shows the request and waits for you to approve it. Once you approve, the change happens right away.
  • Anything that emails a Client asks first. Many Tools can email a Client, for example converting a Work Request, sending a Portal Access Invitation, sending a payment receipt, canceling a Subscription, setting a Follow-up, generating a Sales Room and running a Skill.
  • It never charges a card or sends funds. Recording a payment, changing a balance or canceling a Subscription asks you first.

If your A.I. app resends the same request within 15 minutes, SuiteDash returns the first result instead of doing it twice.

IMPORTANT: Read each approval before you click. A connected app can send a Portal Access Invitation, record a payment or delete a record if your role allows it, and a sent invitation cannot be taken back.


Does it cost anything?

  • Finding, reading and changing records does not use your A.I. usage.
  • Running a Skill from your A.I. app does. It is listed in your A.I. usage as Skill Runs from MCP Apps.
  • Your A.I. app's own subscription (for example, your Claude or ChatGPT plan) is separate.

Are there limits?

  • Each connected app can make up to 60 requests a minute. Each person can make up to 120 a minute across all their apps, and the whole account up to 600 a minute.
  • There is no daily limit.
  • If an app goes faster, it is told "Too many requests. Try again in [number] seconds." and can carry on after that.

Turn on MCP Access for your team

The Super Admin, Admins and Account Managers can manage this.

  1. Open the Flyout Menu (click your profile image) and choose A.I. Studio.
  2. Click the MCP Access tab. It lists your Staff roles.
  3. Open a role and turn MCP Access on.
  4. Under Tools and Skills, choose what that role's connected apps may use. Every Tool and Skill starts on once access is on.
  5. Save. Everyone with that role gets these settings, including Staff you add later.

To give one person different settings, open Manage Staff, open that person's row menu and choose MCP Access. That person then keeps their own settings, shown as Custom MCP Access, until you click Back to Role Defaults.

Staff with access connect their own app from My Account > Connections, which shows the steps, the portal's MCP address and a Setup Prompt.

IMPORTANT: Turning a role's access off disconnects the A.I. apps of everyone following that role. Staff with Custom settings keep their access.


How do I disconnect an app?

  • Your own apps: go to My Account > Connections. Your Connected A.I. Apps lists every app you connected. Click Disconnect next to an app. It stops at once, and you can reconnect it from the app to use it again.
  • A colleague's apps: in Manage Staff, open their row menu, choose MCP Access and click Disconnect next to the app.
  • You can also remove the connector in your A.I. app's own settings.

Your portal also disconnects an app on its own when, for example, your password or two-step sign-in changes, you sign out of all devices, your access is turned off, you leave the team, or the portal's address changes. Connect it again from the app.


Messages you might see

Message What it means
"The MCP address is not available yet." Contact the Help Team.
"Can't Connect This App" with "Use your portal's MCP address to connect this app." You used an address that belongs to another account. The page shows your own address; use that one.
"MCP access is not enabled for you." An administrator has not turned on MCP Access for your role or for you.
"A.I. app connections are for team members." Only Staff can connect an A.I. app.
"A.I. apps can't connect while this account is inactive." The account is not active.
"We Couldn't Identify This App" Ask the app's maker to check its connection settings.
"This page expired. Go back to the app and connect again." The Allow page waited too long. Start again from the app.
"You can't approve an app while signed in as someone else." Stop impersonating, then connect again.
The app connects but sees no Tools Your account has neither the A.I. Service nor an active A.I. Connection. Ask an administrator to add the A.I. Service or connect an A.I. Connection, then reconnect the app.
"This Tool is not enabled for you." That Tool is switched off for your role or for you in MCP Access.
"Too many requests. Try again in [number] seconds." The app went over its limit. It can carry on after the wait.
"Service busy. Try again in [number] seconds." Your portal is busy. Try again after the wait.
"The request timed out. Check the record before retrying." The change may or may not have been made. Look at the record before you ask again.

CLICK HERE for the SuiteDash MCP connector reference.

CLICK HERE to learn about the A.I. Service.

CLICK HERE to learn about A.I. Connections (bring your own key).

CLICK HERE to learn about A.I. Agents and Skills.