Orderful MCP

Connect your AI assistant to your Orderful account.

Beta - Limited availability. The Orderful MCP is rolling out in stages. Setup steps and available tools may change as we add more, and some AI tools need extra setup. If something doesn’t work as described here, email [email protected] and we’ll help.

The Orderful MCP connects your AI assistant to your Orderful account. It works with AI apps such as Claude, ChatGPT, Gemini and Copilot, or with an assistant you build yourself.

It acts as you, in your own organization, with the same permissions you have in Orderful. It can only see what you can see.

Connect

Server address: https://api.orderful.com/mcp

Pick your AI tool below. If yours isn't listed, use the steps under Other AI tools.

Claude

claude.ai and Claude Desktop

On Team and Enterprise plans, an Owner adds Orderful once for the organization. After that, each person connects with their own Orderful login.

To add it for yourself, or as an Owner

  1. Open Customize, then Connectors. Click Add, then Add custom connector. Owners open Organization settings, then Connectors, click Add, hover Custom, and choose Web.
  2. Name it "Orderful" and enter the server address.
  3. Open Advanced settings and enter the client ID 0lDdAjouyRg6TLmGqLU5qW6sofsH7YVq. Leave the secret empty.
  4. Click Add, then Connect, sign in with your Orderful login, and approve access.

To connect as a team member

  1. Open Customize, then Connectors.
  2. Find Orderful, marked Custom, and click Connect. Sign in with your Orderful login and approve access.

To use it

  1. In a chat, click +, then Connectors, and switch Orderful on.
  2. Test it: ask "What do we have set up in Orderful?"

Claude asks before it uses a tool for the first time. Choose Allow once or Allow always. To stop Claude from using a tool, open Customize, then Connectors, select Orderful, and set that tool to Blocked.

To disconnect later, open Customize, then Connectors, and choose Remove from the three-dot menu.

ChatGPT

Which ChatGPT plans can add a custom MCP server depends on your workspace admin settings.

  1. In ChatGPT, open Settings and add a custom MCP server.

  2. Name: "Orderful". Server URL: https://api.orderful.com/mcp. Authentication: OAuth.

  3. Open Advanced OAuth settings and enter these values:

    • Registration method: User-Defined OAuth Client
    • OAuth client ID: 0lDdAjouyRg6TLmGqLU5qW6sofsH7YVq
    • OAuth client secret: leave empty
    • Token endpoint auth method: none
    • Scopes: openid profile email offline_access
    • Auth URL: https://id.orderful.com/authorize
    • Token URL: https://id.orderful.com/oauth/token
    • Resource: https://api.orderful.com/mcp
    • Server supports PKCE (S256): tick the box
  4. Create the connector and click Connect.

    Some ChatGPT connectors use a callback URL we’ve already approved. If you see a “Callback URL mismatch” error, copy the callback URL shown on that screen (or in ChatGPT’s connector settings) and email it to [email protected]. We’ll approve it and confirm when you can connect again.

  5. Test it: ask "What do we have set up in Orderful?"

To disconnect later, remove the connector in ChatGPT settings.

ChatGPT may need a callback URL that Orderful has to approve before you can sign in. If you see a "Callback URL mismatch" error when trying to connect, copy the Callback URL and send it to [email protected].

Gemini

A Gemini Enterprise admin adds Orderful once for the team. After that, each person signs in with their own Orderful login.

  1. As a Gemini Enterprise admin, open Settings & help, select your team, then open Manage team, then Connected apps, then Add MCP Server.
  2. Server URL: https://api.orderful.com/mcp. Name: "Orderful".
  3. Under Authentication, choose OAuth 2.0 and enter these values:
    • Authorization URL: https://id.orderful.com/authorize
    • Token URL: https://id.orderful.com/oauth/token
    • Authorization URL Parameters: &resource=https://api.orderful.com/mcp
    • Client ID: 0lDdAjouyRg6TLmGqLU5qW6sofsH7YVq
    • Client Secret: leave empty
    • Scopes: openid profile email offline_access
    • Enable PKCE Support: tick the box, if you see it
  4. Click Verify Auth, sign in with your Orderful login, approve access, and click Continue.
  5. Name the connector and click Add. The connection is off by default, so turn it on for your team.
  6. Each person opens the connectors menu in Gemini Enterprise and authorizes Orderful once.
  7. Test it: ask "What do we have set up in Orderful?" and name Orderful in your question.

If you use Gemini Enterprise Standard or Plus, an admin adds Orderful in the Google Cloud console instead. Open Gemini Enterprise, select your app, then Connected Data Stores, then New data store, then Custom MCP Server, and enter the same values. When the data store is active, open Actions, reload the custom actions, and enable the Orderful tools.

To disconnect later, remove the connection in Connected apps.

Copilot

Setup for Microsoft 365 Copilot is in progress. Contact [email protected] and we will help you connect.

Other AI tools

  1. In your AI app, add a custom MCP server, which some apps call a connector.

  2. Enter the server address: https://api.orderful.com/mcp

  3. Configure OAuth with these settings. Orderful MCP always signs you in with OAuth. Some apps can't find the sign-in server on their own, so enter the values by hand.

    SettingValue
    Server addresshttps://api.orderful.com/mcp
    AuthenticationOAuth 2.0 authorization code flow with PKCE, method S256
    Client ID0lDdAjouyRg6TLmGqLU5qW6sofsH7YVq
    Client secretNot needed
    Scopesopenid profile email offline_access
    Authorization endpointhttps://id.orderful.com/authorize
    Token endpointhttps://id.orderful.com/oauth/token
    Resourcehttps://api.orderful.com/mcp
    Discoveryhttps://id.orderful.com/.well-known/oauth-authorization-server

    Sign-in uses your Orderful login, and the MCP acts with your permissions. The scopes openid profile email identify you, and offline_access keeps you signed in without logging in again.

  4. Sign in with your Orderful account when asked, and approve access.

  5. Try it: ask "What do we have set up in Orderful?"

To disconnect later, remove the connector in your AI app.

ChatGPT, Gemini and Copilot may need extra coordination to connect, like providing the callback URL. If you need assistance reach out to [email protected].

Tools

See Orderful MCP tools for the full list, what each tool does, when to use it and example prompts. The tools help you troubleshoot transactions, partnerships and relationships, and review recent changes in your organization. More tools are on the way.

Permissions

The tools you can use depend on your role in Orderful. The MCP gives you the same access you have in the Orderful app, and nothing more. If a tool isn't available for your role, it tells you which role is needed.

What it never does

The tools look things up and never change your account. They don't delete anything, and they show EDI message contents only when you ask about a specific transaction.

Questions and feedback

If a tool is missing, gives a wrong answer or is hard to use, email [email protected]. For help with your account, contact Orderful support.


What’s Next

Did this page help you?