Troubleshooting

Fix project MCP connection, authorization, missing tools, and scope issues.

This guide covers common issues when connecting an MCP assistant to a project in More Good Reviews. Most problems come down to the URL you paste, permissions you approve, or using the agency MCP server when you meant the project one.

For agency-level MCP issues (client businesses, portal users, team seats), see Agency MCP Troubleshooting.

---

The assistant cannot connect at all

Use the full MCP Server URL

Copy MCP Server URL from Settings → MCP Server in your project. Paste the entire string into your assistant's connector setup.

Do not paste a generic API host or invent a path. The project URL includes a scoped segment and looks similar to https://api.example.com/mcp/p/….

White-label and custom domains

If your account runs under a white-label agency with a custom API domain, the copied URL uses that host. Always paste the value from your console, not a generic More Good Reviews example.

Re-add the connector after URL changes

If you changed domains or switched projects, remove the old connector and add a new one with the current MCP Server URL, then authorize again.

---

Sign-in or authorization fails

Complete the flow in one session

When you save a new connector, the assistant opens a sign-in window. Finish sign-in and click Authorize before the window closes. If you see a message that the authorization request is missing or expired, start again from Add custom connector.

Choose the correct account

Sign in with the MGR account that owns the project. Client portal users may not have permission to authorize MCP connections.

Grant enough scope

If you only approved Read, the assistant cannot schedule review requests or update records. Remove the connector, reconnect, and approve Write or Delete when you need those actions.

Symptom	Likely cause	Fix
Assistant says it cannot create or update records	Read-only authorization	Reconnect and approve Write
Assistant cannot delete records	Delete scope not granted	Reconnect and approve Delete
Fewer tools than expected	Partial scopes	Reconnect and review all three scope checkboxes

---

Connected but the wrong data appears

Project versus agency server

Project MCP returns customers, reviews, and messages for one business. If you need to create client businesses or manage portal users, use Agency MCP Server instead.

One connector per project

Project MCP is scoped to one project per URL. To work in a different business, remove the connector and add it again with that project's MCP Server URL.

Name the connector in chat

When you run several MCP connectors, start your message with the product and project name ("In More Good Reviews for Bright Dental, …") so the assistant selects the right one.

---

Results look incomplete or truncated

Large lists are paginated

Customer directories, review histories, and message logs may span many pages. Ask the assistant to:

• Narrow the date range ("last 30 days" instead of "all time")

• Cap the count ("latest 100 reviews")

• Request the next page explicitly

Use filters

For customers, filters like not-asked, not-reviewed, and unsubscribed reduce noise. For reviews, filter by score, source, location, or reply status.

---

Connected apps do not show the assistant

After authorization, the assistant should appear under Connected apps on Settings → MCP Server.

1. Confirm authorization finished with a success message.

2. Refresh the settings page.

3. If it still does not appear, revoke any stale entry, remove the connector in the assistant, and connect again.

Each tile shows scopes (read, write, delete) and when the connection was approved. Use Revoke on a tile to cut off one assistant without affecting others.

---

Actions fail or return errors

Review requests blocked

Create Ask respects your request strategy, daily and monthly caps, and unsubscribe status. If sends fail, check Settings → Strategy, email and SMS limits, and whether the customer is unsubscribed.

Integration replies fail

Reply to Review on Integration requires Google or Facebook to be connected in Settings → Integrations. The review must exist on that platform. The assistant should draft replies and wait for your confirmation before publishing.

Icon format on sources and tags

When setting a preset icon (not an uploaded image), use two lowercase words separated by one space, such as fab fa-google or fas fa-star.

---

Disconnect and start fresh

In the assistant. Remove or disable the custom MCP connector.

In MGR. On Settings → MCP Server, click Revoke on the relevant Connected apps tile.

Disconnecting does not delete your reviews, customers, or ratings. It only removes the assistant's access. Reconnect anytime with the same URL and a new authorization.

---

Still stuck?

1. Verify you copied the latest MCP Server URL from Settings → MCP Server.

2. Re-authorize with the scopes you need.

3. Try a simple read-only prompt first ("List my locations") before write or delete tasks.

For tool names and permissions, see Tools. For setup walkthroughs, see MCP Server.