> For the complete documentation index, see [llms.txt](https://docs.moregoodreviews.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moregoodreviews.com/platform/mcp-server/troubleshooting.md).

# Troubleshooting

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.

{% hint style="info" %}
For agency-level MCP issues (client businesses, portal users, team seats), see [**Agency MCP Troubleshooting**](/agencies/mcp-server/troubleshooting.md).
{% endhint %}

***

## 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.

{% hint style="warning" %}
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/…`.
{% endhint %}

### 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**](/agencies/mcp-server.md) 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**](/platform/mcp-server/tools.md). For setup walkthroughs, see [**MCP Server**](/platform/mcp-server.md).