Setup

Prerequisites

  • MCP enabled for your organization by an account admin (one time). Admins: enable it while connecting from your preferred AI workspace (you'll be prompted when you connect), or ahead of time in the Flexport platform via Business Profile → Integrations → MCP Connection.
  • An active Flexport account with role access granted to the tools you need — see Permissions.
  • An AI workspace or agent listed below.

Enabling the Flexport MCP for your organization

A Flexport account admin must enable the MCP once before anyone in your organization can connect. Admins can complete this one-time setup using either option below:

Option 1 – Enable while you connect (stay in your AI workspace)

  1. Initiate the connection to the Flexport MCP from your preferred AI workspace (e.g., Claude) and sign in with your Flexport account credentials when prompted.
  2. When the Enable the MCP Connection page appears, select Enable.
  3. Your connection will complete, and the Flexport MCP will be enabled for your entire organization.

Option 2 – Enable ahead of time in the Flexport platform

  1. Log in to Flexport and go to Business Profile → Integrations → MCP Connection (app.flexport.com/integrations/mcp-connection).
  2. Select Enable the MCP Connection.
  3. You and your colleagues can now connect from your preferred AI workspaces.

Not an admin? If you try to connect before the MCP is enabled for your organization, you'll see a page saying an admin on your Flexport account must enable the Flexport MCP. You can't enable it yourself.

  1. Select Cancel.
  2. Ask an admin on your Flexport account to enable the MCP (either option above). Not sure who your admins are? Contact your Flexport account team.
  3. Once they've enabled it, connect again.

If the Flexport MCP is already enabled for your organization, you won't see these pages. Your connection to the Flexport MCP simply finishes.

Server URL

Every client below connects to the same remote MCP server:

https://mcp.flexport.com/mcp

Connections are initiated from the agent and tied to your individual Flexport account and user role. When your agent redirects you, sign in with your Flexport account to authorize — the whole process takes about a minute.

Claude

From the connectors directory

  1. Go to Customize → Connectors (claude.ai/customize/connectors).
  2. Search for Flexport and click Connect.
  3. Sign in with your Flexport account when redirected.

This is the recommended way to connect — if you previously added Flexport as a custom connector, remove it from Customize → Connectors first to avoid ending up with two connections. On a Team or Enterprise plan, an Owner enables directory connectors from Organization settings → Connectors (claude.ai/admin-settings/connectors); a member without permission to enable connectors sees a Request button there instead, which notifies an Owner. See Claude's connectors directory guide for the current steps if your screen looks different.

Add as a custom connector

Alternatively, add it manually as a custom connector:

  1. Go to Customize → Connectors.
  2. Click +, then Add custom connector, and paste https://mcp.flexport.com/mcp.
  3. Click Add, then sign in with your Flexport account when redirected.

On a Team or Enterprise plan, only an Owner can add a custom connector for the organization, from Organization settings → Connectors instead of the path above. Once added there, members connect their own account from Customize → Connectors. See Claude's custom connector guide for the current steps if your screen looks different.

ChatGPT

From the app directory

  1. Open Apps or Plugins (as available) and search for Flexport.
  2. Select it and click Connect.
  3. Sign in with your Flexport account when redirected.

This is the recommended way to connect. See OpenAI's connected apps guide for the current steps if your screen looks different.

Add as a custom app

Alternatively, add it manually via Developer mode:

  1. Go to Settings → Security and login and turn on Developer mode.
  2. In Apps or Plugins, click + and create a developer-mode app pointing at https://mcp.flexport.com/mcp.
  3. Sign in with your Flexport account when redirected.

Developer mode is web-only, on Pro, Plus, Business, Enterprise, or Edu accounts (not Free). On Business, Enterprise, or Edu workspaces, an admin may need to allow custom apps under workspace settings first. See OpenAI's developer mode guide for the current steps if your screen looks different.

Microsoft Copilot Studio

This connects to a specific agent you build in Copilot Studio — you need an agent to attach it to before you can use it (new or existing).

From the connector catalog

  1. Go to copilotstudio.microsoft.com, sign in, then open (or create) the agent you want to connect under Agents.
  2. Go to the agent's Tools page and select Add a tool.
  3. Search for or select Model Context Protocol to display the available MCP connectors.
  4. Find Flexport in the list and select it.
  5. Authorize the connection: sign in with your Flexport account when prompted and approve access.
  6. Select Add and configure to attach Flexport to your agent. Flexport appears on the agent's Tools page.

This is the recommended way to connect. See Microsoft's MCP catalog setup guide for the current steps if your screen looks different.

Add as a custom connector

Alternatively, if Flexport isn't available in your agent's connector catalog, add it manually:

  1. Open your agent and go to Tools → Add a tool → New tool → Model Context Protocol.
  2. Enter a server name and description, and set Server URL to https://mcp.flexport.com/mcp.
  3. Choose OAuth 2.0, then Dynamic discovery. Select Create, then Next to continue.
  4. Select Create a new connection, sign in with your Flexport account, and approve access when prompted. You can also select an existing connection for your account.
  5. Select Add to agent to attach the connector to your agent.

See Microsoft's custom MCP setup guide for the current steps if your screen looks different.

After connecting, publish the agent to share it with teammates — the first time they use it, they connect their own Flexport account from a Set up Connection prompt in the chat.

Grok Bot

From the marketplace

  1. Open Marketplace from the sidebar in the Grok Bot desktop app.
  2. Find Flexport and select Add.
  3. Complete browser authentication with your Flexport account to authorize the connection.
  4. Return to your Bot's chat, type @, and attach Flexport to the task.

See Grok Bot's connection guide for the current steps if your screen looks different.

Add as a custom MCP server

Alternatively, add the server from a conversation:

  1. Ask your Bot "Add a custom MCP server called Flexport at https://mcp.flexport.com/mcp."
  2. Confirm the server name and URL when the Bot asks.
  3. Follow the authorization prompt and sign in with your Flexport account in the browser.
  4. Start your next message, type @, and attach Flexport to the task.

See Grok Bot's custom connector instructions for more details.

Connections are available to every Bot on your account. On desktop, review installed plugins and enable or disable individual tools from Marketplace → Your plugins. The mobile app shares your connections and lets you install or review plugins from Settings — see Grok Bot's mobile guide.

Verify the connection

Ask your agent "What Flexport tools do you have available?" — it should list tools like track_shipment and rates_search_instant_price (see MCP Tools for the full list). Then try a real request, e.g. "Track shipment FLEX-1234567." The tools available to you are scoped to your Flexport role, so a coworker may see a different list — see Permissions.

You can view and revoke your own connections anytime from User Settings → MCP Connections.

Troubleshooting

Problem What to do
Error that MCP has not been enabled for your organization Account admins: enable MCP using either option above. Other users: ask your account admin to enable it, then connect again. Contact your Flexport account team if you don't know who your admins are.
An admin doesn't see Business Profile → Integrations → MCP Connection Confirm the signed-in user is an account admin. If they are and the page is still missing, contact your Flexport account team.
Connected, but the agent has no Flexport tools, or fewer than expected Tool access is scoped to your Flexport role — see Permissions.
Flexport doesn't appear when searching the connectors directory in Claude Add it as a custom connector instead.
No Add custom connector option in Claude On Team/Enterprise plans, only an Owner can add it, from Organization settings → Connectors.
Flexport doesn't appear when browsing the app directory in ChatGPT Add it as a custom app via Developer mode instead.
No + option to create a custom app in ChatGPT Confirm Developer mode is on under Settings → Security and login; it's web-only and not available on the Free plan.
Flexport doesn't appear in the MCP connector catalog in Copilot Studio Follow Add as a custom connector in the Microsoft Copilot Studio section above.
Connection authorization is incomplete in Grok Bot Open Marketplace → Your plugins on desktop, select the Flexport connection, and complete browser authorization with your Flexport account.
Flexport doesn't appear in Grok Bot's marketplace Add it as a custom MCP server from a conversation instead.
Flexport is installed in Grok Bot, but its tools are unavailable Open Marketplace → Your plugins, confirm the tools are enabled and authentication is complete, then type @ in chat to attach Flexport to the task.
Flexport shows Disabled by team admin in Grok Bot Ask your admin to enable it in the team's Plugins page and allow https://mcp.flexport.com/mcp if an MCP allowlist is in use. Restart Grok Bot afterward. See Grok Bot's connector policy.
➔ Next to Permissions