Stockpile Reports MCP · Setup
Connect your account to
your AI assistant.
A one-time setup connects Stockpile Reports® to Claude, ChatGPT, Gemini, Microsoft Copilot, and more. Sign in once, approve access, and start asking about your stockpiles in plain language.
Before you start
Setup takes a couple of minutes. You'll need three things and one address.
- A Stockpile Reports Business account. The connection is available to Business customers. If your account is Personal or Professional, you won't be able to sign in. Talk to us about moving to Business.
- Your Stockpile Reports email and password. The same login you use for the Web Application or SR Measure. There's no API key to copy; you sign in through your browser.
- An AI assistant that supports remote connectors. This guide covers Claude (web, Desktop, and Cowork), Claude Code, ChatGPT, Gemini (with a personal Google Account), Google's Antigravity CLI (which replaced the Gemini CLI), and Microsoft Copilot Studio. Most other 2025-or-later assistants that can connect to a remote (HTTP) server work the same way.
Connection address
https://mcp.stockpilereports.com/mcpChoose your assistant
Jump to the steps for the tool you use.
Using a different assistant? Most others that support a remote (HTTP) MCP connection with sign-in work the same way: add a custom connector, paste the connection address above, and sign in.
Claude
Claude (web, Desktop & Cowork)#
Add the connection once from the Connectors screen. It's then available across Claude on the web, the desktop app, and Cowork.
- Open Customize → Connectors. On the web, go straight to claude.ai/customize/connectors; in the desktop app, open Customize from the sidebar, or Settings → Connectors, which shows the same list.
- Select Add, at the top right of the Connectors screen, then choose Add custom connector. It's the same on the web and in the desktop app. The Add custom connector panel opens; there are two steps.
- On step 1, fill in:
- Name Stockpile Reports
- MCP server URL https://mcp.stockpilereports.com/mcp
- Step 2 looks more involved than it is: change nothing. Claude reads these off the server and marks them Detected:
- Authentication Sign in now
- OAuth client Register automaticallyClaude registers itself with Stockpile Reports. The option above it, Use Claude's published identity, needs something Stockpile Reports doesn't support, so leave it alone.
- Select Add to create the connector. Claude opens its page and says you're not connected yet: select Connect. A Stockpile Reports sign-in page opens. Sign in with your email and password, then select Allow. Claude confirms Connected to Stockpile Reports and lists the connection's tools.
- Start a chat and ask one of the example questions.
Anthropic's own setup docs: Get started with custom connectors using remote MCP.
Claude
Claude Code (command line & IDE)#
Add the connection with one command, then sign in from inside a session.
claude mcp list first and look for a Stockpile Reports line
labelled claude.ai. If it's there and says Connected, you're done,
and you can go straight to the example questions. There's no need to add it again.
- In your terminal, run:
claude mcp add --transport http stockpile-reports https://mcp.stockpilereports.com/mcp --scope user - Start Claude Code with
claude, then run/mcp, choose stockpile-reports, and select Authenticate. A Stockpile Reports sign-in window opens in your browser. Sign in with your email and password, then select Allow. - Confirm it's connected with
claude mcp list, which shows the connection with a Connected status. To see the individual tools, run/mcpin a session and select stockpile-reports. - In your session, ask one of the example questions.
--scope user makes the connection available in every project on your machine.
Leave it off and the connection is added for the project you're in and nothing else. There is also
--scope project, which does the opposite of limiting it: that one writes a
.mcp.json into the project, which everyone who clones it picks up. The same setup works in the
Claude Code extensions for VS Code and JetBrains.
Anthropic's own setup docs: Connect to MCP servers.
ChatGPT
ChatGPT (web)#
Custom connections in ChatGPT are set up on the web (chatgpt.com). Once added, the connection also works in the ChatGPT mobile app. A paid plan is not required; this works on a free ChatGPT account. On a Business, Enterprise, or Edu workspace, OpenAI says an admin or owner adds it, or gives you permission to.
- On chatgpt.com, open Plugins in the left sidebar. Select Add at the top right, then Add custom MCP server. A panel of the same name opens.
- Fill in the details:
- Name Stockpile Reports
- Description Your Stockpile Reports account: sites, piles (stockpiles), products (the material in a pile), bunkers, users, and volume and weight/tonnage measurements. Use it for questions about inventory, measurement history and trends, and for requests involving these records.Optional.
- Connection Leave this set to Server URLThe other choice, Tunnel, is for a server running on your own machine.
- Server URL https://mcp.stockpilereports.com/mcpThe box under Connection; it has no label of its own.
- Authentication OAuthAlready selected. Leave Advanced OAuth settings alone; ChatGPT reads what it needs from the server.
- Tick I understand and want to continue under the risk warning. Create as a plugin stays greyed out until you do.
- Select Create as a plugin. ChatGPT asks you to confirm in a Connect Stockpile Reports panel: select Connect Stockpile Reports. A Stockpile Reports sign-in page opens in the same tab. Sign in with your email and password, then select Allow. ChatGPT returns to the Plugins page and confirms the connection.
- Start a chat and ask one of the example questions.
OpenAI's own setup docs: Connecting custom MCP servers in ChatGPT.
Gemini
Gemini (web)#
Add the connection once on the Gemini website. It then works in Gemini on the web and in the Gemini mobile app.
This needs a personal Google Account. Google doesn't offer custom connections on a work or school account, so if you sign in to Gemini with your company's Google account, use Google Antigravity instead. Google also requires that you're 18 or over, in the US, using Gemini in English, with Keep Activity turned on (Google's full list).
- Open Gemini's Connectors page, or on gemini.google.com open Customize in the sidebar and select the Connectors tab. Select + Custom, at the top right beside the search box. If there's no + Custom, you're most likely signed in with a work or school account.
- Fill in:
- MCP Server URL https://mcp.stockpilereports.com/mcp
- Google shows Connect this MCP server, listing what Gemini will be able to do. Scroll to the bottom, tick I understand and accept the security and privacy risks of connecting this custom app, and select Connect.
- Google then asks you to link your Google Account to Stockpile Reports, on a page it titles Link your Google Account and [Custom] Stockpilereports account. Scroll down and select Agree and continue.
- A Stockpile Reports sign-in page opens. Sign in with your email and password, then select Allow.
- Gemini shows Save your custom app, with the name Stockpile Reports filled in and a list of its available actions. Select Connect.
- Start a chat and ask one of the example questions. To make sure Gemini uses Stockpile Reports for a question, type
@first and choose Stockpile Reports from the list.
@ and choosing Stockpile Reports.
Google's own setup docs: Connect & manage custom apps for Gemini Apps.
Google Antigravity
Google Antigravity (command line)#
Add the connection with one command, then sign in from inside a session. Antigravity CLI is Google's terminal assistant, and it replaced the Gemini CLI in June 2026.
- Install the Antigravity CLI, then run
agyonce, choose Google OAuth, and sign in with your Google Account. A work account is fine. - In your terminal, run:
agy mcp add stockpile-reports https://mcp.stockpilereports.com/mcp - Start
agy, run/mcp, and select stockpile-reports. Until you sign in it is marked [Auth Needed], with an Unauthorized error beside it. That is expected.agy mcp listwon't tell you either way; it shows what you have configured, not whether it's connected. - Select Authenticate. A Stockpile Reports sign-in window opens in your browser. Sign in with your email and password, then select Allow. Google shows you an authorization code: copy it, paste it at the terminal prompt, and press Enter. The terminal reports Authentication successful!
- In your session, ask one of the example questions. Antigravity asks before it uses each Stockpile Reports tool for the first time; choosing Yes, and always allow for the conversation stops it asking again.
gemini mcp add --transport http stockpile-reports https://mcp.stockpilereports.com/mcp,
and sign in with /mcp auth stockpile-reports. On any other account, use the steps above.
Google's own setup docs: MCP in Antigravity.
Microsoft Copilot
Microsoft Copilot (Copilot Studio)#
Copilot connects through Copilot Studio, where Stockpile Reports is added as a tool on an agent. It's a few more steps than the other assistants, and the right path for organizations standardized on Copilot.
Setup happens in three parts, and you may only need the first. One person, usually whoever administers Copilot Studio, registers Stockpile Reports once for the whole organization (Part 1). Colleagues who want to build their own agent then skip most of the work (Part 2). And if you'd rather your team simply used the agent you built, without opening Copilot Studio at all, that's Part 3.
Part 1: Register Stockpile Reports (once per organization)#
- Open Copilot Studio and check which environment you're in. The link opens your default one, and the name isn't shown anywhere on the page: the switcher is a small icon near the bottom-left, and hovering over it tells you where you are. Make a note of the environment you build in, because your colleagues will need it in Part 2.
- Open Agents in the left sidebar and select the agent you want to connect. To start a new one instead, select New agent; it opens straight into the new agent, where you can type a name over Untitled Agent. You can leave the instructions empty and the model as it is; neither affects the connection.
- In the panel on the right, select + next to Tools. In the Add a tool dialog, select + Add, then Model Context Protocol (MCP).
- Fill in the Add MCP server form:
- Server name Stockpile Reports
- Server description Your Stockpile Reports account: sites, piles (stockpiles), products (the material in a pile), bunkers, users, and volume and weight/tonnage measurements. Use it for questions about inventory, measurement history and trends, and for requests involving these records.Required. Copilot uses it to decide when to call the connection.
- Server URL https://mcp.stockpilereports.com/mcp
- Authentication OAuth 2.0
- Configuration type Dynamic (with discovery)Appears once you choose OAuth 2.0, already selected. Leave it as it is.
- Select Add. Copilot reads the server and shows the Select a connection dialog, with the connection listed as Not connected. If it says Can't create MCP server. Try again. instead, Stockpile Reports is most likely already registered in this environment, perhaps by a colleague: follow Part 2 instead.
- Open the dropdown to the right of the Stockpile Reports connection, choose Create new connection, then select Create.
- A Stockpile Reports sign-in window opens in a separate browser window. Sign in with your email and password, then select Allow. Watch for that window: it can open behind your main one, or be stopped by a pop-up blocker.
- Back in the Select a connection dialog, the connection now shows a green check. Select Add, then save your agent using the disk icon at the top right.
- Open the Preview tab at the top of the page and ask one of the example questions. If Copilot shows a card asking permission to use Stockpile Reports, select Allow.
Part 2: For everyone else#
Once Part 1 is done, Stockpile Reports is available to anyone building an agent in the same Copilot Studio environment. There's no server URL to paste and nothing to configure. Two things do have to be true, though.
You need to be in the same environment the person in Part 1 used. Copilot Studio opens your default environment, so if Part 1 happened somewhere else, the search in step 3 quietly finds nothing. And you need permission to build agents there. If Copilot Studio moves you to a different environment when you try to open that one, that's the permission you're missing, and your Copilot Studio admin can grant it.
- Open Copilot Studio and switch to the environment where Part 1 was done. The switcher is a small icon near the bottom-left, and hovering over it tells you where you are.
- Open Agents in the left sidebar and select your agent, or select New agent and give it a name. The instructions and the model can stay as they are. Then select + next to Tools.
- In the Add a tool dialog, choose the Model Context Protocol (MCP) tab and search for Stockpile Reports. That tab lists Microsoft's own servers until you search, so don't expect to see it before then. Select it.
- In the Select a connection dialog: if you've connected before, your existing connection is already chosen and you can go straight to the next step. If not, open the dropdown to the right of the Stockpile Reports connection, choose Create new connection, then sign in with your own Stockpile Reports email and password and select Allow.
- Select Add, then save your agent.
- Open the Preview tab at the top of the page and ask one of the example questions. If Copilot shows a card asking permission to use Stockpile Reports, select Allow.
Part 3: Let your team use the agent you built#
Parts 1 and 2 give an agent to whoever builds it. Part 3 hands your agent to colleagues who never open Copilot Studio. They use it from Microsoft 365 Copilot like any other agent.
End user account (recommended, and the default): each colleague signs in with their own Stockpile Reports login and sees their own sites and piles. If your account uses organizations, each person keeps the access you've given them. Costs them a one-time sign-in, described below.
Shared account: nobody signs in, and every colleague's questions run through your Stockpile Reports account and return what you can see, and any change a colleague asks for is made as you, using your role and access. This is the easier setting, which is exactly why it's worth choosing deliberately: if your account uses organizations, it bypasses that scoping entirely. Sensible for a shared team login, wrong if people are meant to see different things.
If you built the agent#
- In Copilot Studio, open your agent. In the panel on the right, select + next to Channels, then choose Teams + Microsoft 365.
- Leave Microsoft Copilot and Microsoft Teams selected and choose Add channel. Take a moment here. Copilot Studio says this choice can't be changed after publishing.
- Select Publish at the top right, then Publish agent.
- Select Share. It's offered on the panel that appears once publishing finishes, and remains available from your agent afterwards. Add the colleagues or groups who should use it, and select Share.
- The Agent shared successfully panel has a Copy link button with an arrow beside it. The button names a destination (it may read Copy link (Microsoft Teams)), so open the arrow and choose Microsoft Copilot. That copies the install link your colleagues need, and the button changes to Copied. It should start
https://m365.cloud.microsoft/chat/?titleId=. - In a separate browser tab, give them permission in the Power Platform admin center. Sharing the agent does not do this, and without it they cannot connect. Go to admin.powerplatform.microsoft.com, select Manage in the left sidebar and then Environments, and open the environment your agent is in. Under the Access card, select See all beneath Users. Find your colleague in the list and open their summary panel. Choose Manage roles, then Basic User, and Save. A Role assignment confirmation dialog then lists every role they will hold and asks again; select Save a second time, or nothing is granted. Not in the list? Select Add user, enter their work email address, and give them Basic User there. A colleague you have just added to Microsoft 365 may not appear on this page right away; adding them yourself creates them immediately.
- Share the Stockpile Reports connector with them too. Go to make.powerapps.com, check the environment at the top right is the one your agent is in, and select Custom connectors in the left sidebar. On the Stockpile Reports row, open … and choose Invite another user, which opens the connector's Share tab. Add your colleague, leave their permission on Can view, and select Save. Share with org on the same tab covers everyone at once.
- Send them the install link, along with the steps to follow: If someone shared this agent with you is linkable directly.
If someone shared this agent with you#
- Open the link you were sent. If you're prompted to sign in, use your work Microsoft account, the one you use for Microsoft 365. Then select Add. If you don't have a link, ask whoever set up the agent: a shared agent can't be found by searching.
- Select Agents in the sidebar and choose the agent; Add doesn't always open it for you. Then ask your question, for example How many active piles do we have?
- Copilot replies with a card naming the connection and saying Connect your account, then select “Continue”. Select Connect. There may be two of these cards; one connection covers both.
- A Connections window opens, showing the Stockpile Reports connector. Enter a Display name if you like, such as your own name, then select Create.
- Sign in to Stockpile Reports with your own email and password and select Allow. The window shows Saving the connection and then closes by itself.
- Back in the chat, select Continue on the card. If there are two cards, select Continue on each; the answer appears after the second.
Steps 3 to 5 happen once; the connection is yours from then on.
Microsoft's own setup docs: Connect your agent to an existing MCP server covers Part 1, and Share agents with other users and makers covers Part 3.
What you can ask
Once connected, ask in plain language. Answers come back grounded in your own measurements, not guesses. Here are a few to get you started.
- What's my total tonnage of #57 stone across all sites right now?
- List my sites and how many active piles are at each one.
- Show me the most recent measurement for the salt pile at my north yard.
- Which products are set up at my Denver yard, and what conversion factors do they use?
- How has the measured volume of that pile changed over the last three months?
- Which piles did we measure by drone last month?
- Who has access to my account, and what role does each person have?
What your assistant can see and do
The connection is tied to your own account, so you stay in control.
- Looks things up. Your assistant can read your sites, products, piles, bunkers, measurements, and users.
- Makes changes when you ask. As well as reading, it can make changes in your account when you ask it to. Deleting or deactivating a site can also affect what sits under it, and reactivating the site may not bring those back. A deletion cannot be undone, so be specific about what you ask for, and read what your assistant says it is about to do.
- Bounded by your own permissions. It acts as you, with your role and your access, and nothing more. If your role does not let you change something in the Web Application, it cannot change it either.
- Scoped to your account. It sees only data in your Stockpile Reports account. If your account uses organizations, it sees only the parts you can already see in the Web Application.
- Your sign-in, your control. You connect with your own credentials and approve access once. You can disconnect at any time from your assistant's connector settings.
Troubleshooting
A few things that come up during setup.
It says I can't sign in, or that a Business subscription is required.
The connection is available to Stockpile Reports Business accounts. If your account is Personal or Professional, reach out and we'll help you move to a Business plan.
The sign-in window didn't open, or it was blocked.
Allow pop-ups for your assistant and try again. If a tab opened but looks stuck, close it and re-trigger the connection. In Claude Code or the Antigravity CLI you can re-run the authenticate step.
Do I need an API key?
No. You sign in with the same Stockpile Reports email and password you use for the Web Application. There's nothing to copy or paste besides the connection address.
My account uses single sign-on (SSO).
SSO sign-in for the connection isn't available yet. For now, continue to use the Web Application; we'll let you know when SSO is supported.
My assistant has no way to add a connector.
It needs to support remote (HTTP) Model Context Protocol connections. Most assistants released in 2025 or later do. If yours doesn't, use one of the assistants in this guide.
I was asked to sign in again.
That's expected after a long stretch without using the connection, or if you've signed out. Just sign in again and select Allow; your account stays protected behind your login.
ChatGPT doesn't seem to know about something Stockpile Reports can do.
ChatGPT reads the list of things a connection can do when you add it, and doesn't check for changes on its own. So when Stockpile Reports gains something new, a ChatGPT connection you added earlier won't know about it until you refresh it. The same step helps if ChatGPT asks permission every time it looks something up, or shows no Stockpile Reports tools at all.
To refresh it, open Plugins in the left sidebar on chatgpt.com, select Installed at the top of the page, then select Stockpile Reports. Scroll to Manage app and select Refresh tools. The button shows a spinner for a few seconds while it works; no message follows. Then start a new conversation.
If Stockpile Reports isn't listed, or refreshing doesn't help, remove it with Delete app, just below Refresh tools, and add it again using the steps above. Use Delete app rather than Uninstall: an uninstalled connection stays under Plugins → Personal, and ChatGPT won't let you add another with the same name.
Copilot keeps asking me to connect, even though I already did.
A saved connection isn't always one the agent can use. An incognito window in Chrome is the quickest thing to try, setting the connection up again there: in our testing that cleared it at once where a normal window would not. Don't use a Safari private window for this, which fails in a different way: the connection is never saved and the sign-in reports “Unable to sign in. Please try again.” A normal Safari window is fine. If it doesn't help, the agent's tool binding may have gone stale: open the agent in Copilot Studio and Publish it again, leaving the tool's Authentication setting alone.
My colleague sees “Your organization has prevented this agent from being installed.”
They haven't been shared the agent. Sending them the install link isn't enough on its own: sharing the agent decides whether they can install it, and the security role and connector share decide whether they can connect it, so they fail at different points. Open your agent in Copilot Studio, select Share, add them, and have them reload the install link. A reload is enough; they don't need to sign out. If they get past the install card and then see “Connector information unavailable,” that's the other gate, below.
My colleague sees “Connector information unavailable.”
They can't read the Stockpile Reports connector yet. The message says “Please try again later,” but waiting never helps. Share the connector with them (Part 3, step 7) and make sure they have Basic User (step 6), then have them select Retry; once the share is saved, Retry loads the connector straight away. A security role on its own, including Environment Maker, produces this exact screen, because it lets someone read only the connectors they own, not the one you built.
A colleague says the Copilot agent replies but never answers with data.
First, check that they waited, and that they selected Continue on every card: when a question needs two lookups, the answer appears only after the second. If they did, they almost certainly haven't connected yet. The giveaway is a reply like “I'll look that up” with nothing after it, or “the request wasn't approved.” Ask them to send a question, then use the Connect button on the card that appears (Part 3, If someone shared this agent with you). If they were sent a Set up connections link that never finishes loading, that's the wrong link; the card is the way in. If no card appears at all, just a reply that trails off, open the agent in Copilot Studio and Publish it again, leaving the tool's Authentication setting alone. That re-establishes the link between the agent and its tools, and the cards come back. It is worth trying whenever the agent behaves as though the connection is not there, including the loop above, though it does not always help.
Still stuck?
Email support@stockpilereports.com and tell us which assistant you're connecting and where it stopped. A screenshot of the error helps.