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
- Open Customize, then Connectors. Click Add, then Add custom connector. Owners open Organization settings, then Connectors, click Add, hover Custom, and choose Web.
- Name it "Orderful" and enter the server address.
- Open Advanced settings and enter the client ID
0lDdAjouyRg6TLmGqLU5qW6sofsH7YVq. Leave the secret empty. - Click Add, then Connect, sign in with your Orderful login, and approve access.
To connect as a team member
- Open Customize, then Connectors.
- Find Orderful, marked Custom, and click Connect. Sign in with your Orderful login and approve access.
To use it
- In a chat, click +, then Connectors, and switch Orderful on.
- 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.
- Add the server. Run this in your terminal:
claude mcp add --transport http --client-id 0lDdAjouyRg6TLmGqLU5qW6sofsH7YVq --callback-port 8081 orderful https://api.orderful.com/mcpUse port 8081, because that's the callback Orderful has approved.
- Start Claude Code, run
/mcp, choose orderful, and sign in with your Orderful login. - Test it: ask "What do we have set up in Orderful?"
To share the setup with your team, add this to .mcp.json in your project instead of running the command:
{
"mcpServers": {
"orderful": {
"type": "http",
"url": "https://api.orderful.com/mcp",
"oauth": { "clientId": "0lDdAjouyRg6TLmGqLU5qW6sofsH7YVq", "callbackPort": 8081 }
}
}
}Each person still signs in with their own Orderful login.
To check or remove the connection, run claude mcp list or claude mcp remove orderful.
ChatGPT
Which ChatGPT plans can add a custom MCP server depends on your workspace admin settings.
-
In ChatGPT, open Settings and add a custom MCP server.
-
Name: "Orderful". Server URL:
https://api.orderful.com/mcp. Authentication: OAuth. -
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
-
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.
-
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].
- Check that you have a recent Codex. Run
codex --version. If Codex isn't installed, runnpm install -g @openai/codex. If it is installed, update it, because older versions can't use a fixed client ID. - Add the server to your Codex settings file,
~/.codex/config.toml. Run this in your terminal, which creates the file if needed and adds the server:
mkdir -p ~/.codex
cat >> ~/.codex/config.toml <<'EOF'
[mcp_servers.orderful]
url = "https://api.orderful.com/mcp"
scopes = ["openid", "profile", "email", "offline_access"]
[mcp_servers.orderful.oauth]
client_id = "0lDdAjouyRg6TLmGqLU5qW6sofsH7YVq"
callback_port = 8081
EOFEnter the server address exactly as shown, with no slash at the end. If you already added Orderful with codex mcp add, run codex mcp remove orderful first, so the server isn't listed twice.
- Run
codex mcp login orderful. Your browser opens. Sign in with your Orderful login and approve access. - Start Codex and run
/mcpto check thatorderfulis connected. - Test it: ask "What do we have set up in Orderful?"
Use port 8081, because that's the callback Orderful has approved.
Sign-in opens a browser on the same computer, so it doesn't work over SSH or in a container without a browser.
If you see "Dynamic client registration not supported", your Codex is out of date or the client_id line is missing. If the browser shows a redirect error, contact [email protected] with the address shown in the browser bar.
To disconnect later, run codex mcp logout orderful, then remove the orderful entries from config.toml.
Gemini
A Gemini Enterprise admin adds Orderful once for the team. After that, each person signs in with their own Orderful login.
- As a Gemini Enterprise admin, open Settings & help, select your team, then open Manage team, then Connected apps, then Add MCP Server.
- Server URL:
https://api.orderful.com/mcp. Name: "Orderful". - 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
- Authorization URL:
- Click Verify Auth, sign in with your Orderful login, approve access, and click Continue.
- Name the connector and click Add. The connection is off by default, so turn it on for your team.
- Each person opens the connectors menu in Gemini Enterprise and authorizes Orderful once.
- 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.
gemini.google.com and the Gemini mobile app
Whether you can add a custom app depends on your Google account type and your workspace admin settings.
- In Gemini, open Settings, then Connected Apps.
- Under Custom apps, click Add a custom app.
- MCP server URL:
https://api.orderful.com/mcp - Next to Advanced features, click Show more and enter these values:
- Client ID:
0lDdAjouyRg6TLmGqLU5qW6sofsH7YVq - Client secret: leave empty
- Client ID:
- Copy the callback URL that Gemini shows and send it to [email protected]. Orderful has to approve it before you can sign in.
- When we confirm, click Next, sign in with your Orderful login, and approve access.
- Test it: ask "What do we have set up in Orderful?"
To disconnect later, remove the app in Settings, then Connected Apps.
Gemini needs a callback URL that Orderful has to approve before you can sign in. Copy the callback URL that Gemini shows and send it to [email protected].
- Open your Gemini CLI settings file. This command creates the file if it doesn't exist and opens it in TextEdit on a Mac. On Linux, replace
open -ewithnano.
mkdir -p ~/.gemini
[ -f ~/.gemini/settings.json ] || echo '{}' > ~/.gemini/settings.json
open -e ~/.gemini/settings.json- Add the
orderfulentry insidemcpServers. If the file already has other settings, keep them and add the entry to the existingmcpServerssection.
{
"mcpServers": {
"orderful": {
"httpUrl": "https://api.orderful.com/mcp",
"oauth": {
"enabled": true,
"clientId": "0lDdAjouyRg6TLmGqLU5qW6sofsH7YVq",
"authorizationUrl": "https://id.orderful.com/authorize",
"tokenUrl": "https://id.orderful.com/oauth/token",
"scopes": ["openid", "profile", "email", "offline_access"],
"redirectUri": "http://localhost:7777/oauth/callback"
}
}
}
}- Start Gemini CLI. In your terminal, run
gemini. - Run
/mcp auth orderful. Your browser opens. Sign in with your Orderful login and approve access. - Run
/mcpto check thatorderfulis connected and its tools are listed. - Test it: ask "What do we have set up in Orderful?"
Sign-in opens a browser on the same computer, so it doesn't work over SSH or in a container without a browser.
To disconnect later, remove the orderful entry from settings.json.
Copilot
Setup for Microsoft 365 Copilot is in progress. Contact [email protected] and we will help you connect.
Setup for GitHub Copilot is in progress. Contact [email protected] and we will help you connect.
Other AI tools
-
In your AI app, add a custom MCP server, which some apps call a connector.
-
Enter the server address:
https://api.orderful.com/mcp -
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.
Setting Value Server address https://api.orderful.com/mcpAuthentication OAuth 2.0 authorization code flow with PKCE, method S256 Client ID 0lDdAjouyRg6TLmGqLU5qW6sofsH7YVqClient secret Not needed Scopes openid profile email offline_accessAuthorization endpoint https://id.orderful.com/authorizeToken endpoint https://id.orderful.com/oauth/tokenResource https://api.orderful.com/mcpDiscovery https://id.orderful.com/.well-known/oauth-authorization-serverSign-in uses your Orderful login, and the MCP acts with your permissions. The scopes
openid profile emailidentify you, andoffline_accesskeeps you signed in without logging in again. -
Sign in with your Orderful account when asked, and approve access.
-
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.
Updated about 1 hour ago

