Skip to content

ADVANCED · 3.5

How to add a custom MCP connector or plugin

Add a custom MCP server only when Connect apps does not already cover the job, and never paste secrets into chat.

Level
Advanced
Prerequisites
None

The documentation describes connecting apps, and it mentions adding an app’s MCP server when you need a custom connection. We do not invent a full server-field list or a step-by-step admin console we have not verified in the current app. This lesson covers the safe order: use a built-in connector first, then follow the app’s own setup for a custom MCP or plugin, and keep secrets out of chat.

The plugin troubleshooting guide is still the right checklist: open Connect apps, confirm the app is listed, choose Authenticate (Authorize on the phone), finish in the browser, and return to Grok Bot. Added means installed, not signed in. Some apps need a value, such as a server URL, before you can sign in. If Grok Bot says to finish setting up the app before signing in, add the values its setup asks for on the app’s page, then connect again. If the provider keeps rejecting a Client Secret, update that secret in the app’s connector settings, then reconnect — signing in again without fixing it will not keep the app connected.

Bot Agents 24 is an independent guide. It is not affiliated with, endorsed by or sponsored by xAI. Grok Bot is a product of xAI. Labels in the app can change; if a name you see here does not match your screen, follow the wording in your app.

Step 1: Check Connect apps before you build anything custom

Open Connect apps from the sidebar (desktop shortcut Cmd/Ctrl+Shift+M or Cmd/Ctrl+Shift+W). If the service you need is already listed, connect it and stop. A custom MCP server is extra surface area to secure, and it is not the first move for Gmail, a calendar, or other apps the catalog already covers on your account.

Step 2: Add the custom app only from the setup screen

If you need a custom MCP server, follow the add-app or custom-connector wording in your app and in the docs for your version. Enter a server URL and any required values on that setup page, not in a chat message. Do not paste API keys, client secrets, or tokens into ordinary chat. If a Bot or a teammate asks you to dump a secret in the transcript, refuse and use Vault or the connector settings instead.

Paste this into: Grok Bot chat, message box.

Boundary for a custom connectionFree prompt: copy and paste
I am considering a custom MCP or plugin connection for an internal tool at Lumen Street Bookkeeping in Austin, Texas. Do not ask me to paste API keys, tokens, or passwords in this chat. Instead, list the questions I should answer before I add it (what system, what the Bot should be allowed to read or write, and what must wait for my approval). Then tell me to finish any Connect apps or setup screen in the app, not here.

Step 3: Authenticate, then test with a read-only task

Complete authorization with the intended account in the browser. If a connect card is waiting, use Reopen, Try again, or Retry as the card offers. Then ask the Bot to do a read-only check (list, summarize) and to stop before any write. If the app shows Disabled by team admin, ask your Cursor team admin. If you must remove and re-add the app, the docs support that after a revoked authorization.

Paste this into: Grok Bot chat, message box.

Read-only testFree prompt: copy and paste
Using only the custom or connected app we just set up, do a read-only check: tell me whether you can see it and list one safe piece of non-private metadata (for example, the account or workspace name). Do not write, delete, send, or change any records. If you cannot connect, describe the status you see and stop.

What to watch for

If you are not comfortable running a custom server, stay on documented connectors and the cloud computer’s browser (lesson 2.4) for one-off tasks. A custom connection is optional advanced work, not a requirement for the rest of this course.

Quick quiz

Quick quiz

Question 1: What should you try before adding a custom MCP server?

Question 2: Where should a client secret or server URL be entered?

Question 3: What does “Added” mean in Connect apps, according to the troubleshooting guide?

Saved in this browser only; no account needed.

FAQ

Do I need a custom MCP connector to finish the capstone?

No. The capstone can use built-in connectors, the cloud computer, and drafts for your approval.

The Bot says the provider rejected the Client Secret. What now?

The troubleshooting guide says: update the Client Secret in the app’s connector settings, then reconnect. Signing in again without fixing it will not keep the app connected.

Is this an xAI website?

No. Bot Agents 24 is an independent guide. It is not affiliated with, endorsed by or sponsored by xAI.

Sources

  1. How Grok Bot works (Grok Bot docs), checked November 11, 2026
  2. Troubleshooting (Grok Bot docs), checked November 11, 2026
  3. Computer and apps (Grok Bot docs), checked November 11, 2026