API

Connect ChatGPT

What a ChatGPT workspace administrator needs to add GeoReputation as a custom MCP server, including the plan gate and the OAuth client we have to issue for your workspace.

This page is written for the person who will actually do the work, which on ChatGPT is usually a workspace administrator rather than the person who wants the data. If that is not you, send them this link.

The Claude connector is self-serve and takes about a minute. ChatGPT is not that, and the difference is OpenAI's, not ours.

Before you start, two things gate this

A workspace, not a personal plan. OpenAI's page on custom MCP servers says custom MCP server connections and full MCP support are available for ChatGPT Business and Enterprise or Edu customers, on ChatGPT web. The same page's FAQ then says Pro users can connect custom MCP servers with read and fetch permissions. Those two statements do not agree with each other, and we have not tested a Pro account, so here is the honest version: our server is read-only, so it is the shape the Pro line describes, and it is worth ten minutes to try. Plus is not named anywhere on that page. If you are on Plus, treat this as unavailable and use the scheduled report export instead.

Mobile is out either way. OpenAI's FAQ answers "Can I connect custom MCP servers on mobile?" with "No, web only."

We have to issue you an OAuth client before this will work. The client ID published on the Claude page is registered against Claude's callback address and nothing else, so ChatGPT's sign-in will fail with it. Email support@georeputation.com with your workspace name, and when ChatGPT shows you the callback URL it wants to use, send us that too. We register it and issue a client for your workspace.

You also need the API Access add-on on your GeoReputation account. Without it the connection completes and then every question comes back saying the add-on is missing. An account owner enables it in Settings.

Who in the workspace can do this

PlanWho creates the connectionWho publishes it
BusinessAdmins and owners onlyAdmins and owners only
Enterprise or EduAdmins and owners, plus any member an admin grants the permission by RBACAdmins and owners only

The permission an Enterprise admin is granting is called Create plugins with MCPs. On Business there is no delegation: if you are not an admin or an owner, you cannot do this part.

Note that creating and publishing are two separate steps. A connection you create is private to you until an admin publishes it for the workspace, which is deliberate on OpenAI's side so somebody vets the server first.

Add the server

Developer Mode used to be a prerequisite and is not any more. OpenAI's wording: "In the current Plugins experience, add a custom MCP server directly from Plugins. You don't need to turn on Developer Mode first."

  1. Go to Plugins

  2. Select the plus button, then Add custom MCP server

  3. Enter a name, and a description if you want one. GeoReputation is fine for the name

  4. Under Connection, enter the server URL:

    https://mcp.georeputation.com/mcp
  5. Configure authentication, using the OAuth client we issued you

  6. Read the risk warning and tick I understand and want to continue

  7. Select Create as a plugin, then review the tools it discovered

You should see eleven tools, all read-only. The four you will use most are list_brands, get_brand_visibility, list_prompt_performance and explain_change; the rest cover recommendations, reports, monitoring runs, individual answers and, for agency accounts, the client list. If no tools appear, the sign-in did not finish. Remove the connection and add it again.

Publish it for the workspace

Only an admin or owner can do this, and only after the connection has been tested.

  1. Open the Admin Console and select the workspace
  2. Open Plugins, then Manage Legacy Apps
  3. Select Drafts, then Publish

On Enterprise and Edu, the publish dialog has Configure Actions, which lets you turn individual tools on and off, and Configure Access, which limits the plugin to specific groups. All four of our tools read; there is nothing destructive to withhold, so the usual answer is to enable all four.

Once published, members find it under Settings > Plugins and use it by typing @ in a conversation and selecting it.

Two behaviours worth planning around

Tool changes do not reach you automatically. After an admin approves the connection, ChatGPT works from a frozen snapshot of our tools. If we add a tool or change one, your workspace keeps the old set until an admin uses Refresh in the workspace app settings. New actions arrive disabled by default. This is OpenAI's design and we cannot push an update to you.

Sign-in needs refresh tokens to stay signed in. OpenAI's page asks you to confirm the provider advertises offline_access in its discovery metadata, because without it ChatGPT loses access when the first authorization expires and everyone has to sign in again. Ours does advertise it, so there is nothing for you to configure, and you can confirm it yourself at https://api.georeputation.com/oauth/.well-known/openid-configuration.

What to send your administrator

Everything they need is on this page, but if it is easier to paste into a ticket:

Please add GeoReputation as a custom MCP server in our ChatGPT workspace.

Server URL:   https://mcp.georeputation.com/mcp
Access:       read-only, four tools, no write or delete actions
Vendor:       Fairview Labs, Inc. (GeoReputation)
Setup guide:  https://georeputation.com/docs/api/mcp-chatgpt
Privacy:      https://georeputation.com/privacy
Support:      support@georeputation.com

GeoReputation has to issue an OAuth client for our workspace before sign-in
will work. Email support@georeputation.com with the workspace name and the
callback URL ChatGPT shows during setup.

If something does not work

  • Sign-in fails or loops. Almost always the OAuth client. The published client ID is Claude's and will not work here. Check you are using the one we issued for your workspace.
  • The plugin connects but has no tools. The tool list is read over the signed-in connection, so an incomplete sign-in can leave you with a plugin and no tools. Remove it and add it again.
  • Every question says the add-on is missing. The connection is fine. The GeoReputation account needs API Access, which an owner enables in Settings.
  • A member cannot see the plugin. It is still a draft, or RBAC has not granted them access. Both are workspace settings rather than anything on our side.
  • Answers stop partway through a long question. Each connection is limited to 60 requests a minute. Ask about one brand or one window at a time.