AI assistant (MCP)¶
Ask Claude or ChatGPT about your inquiries, quotes, customers, inventory, shop issues, and production work. The assistant uses your AirShop login, so it only sees and changes what that person is allowed to do in AirShop.
Beta
AI assistant (MCP) is in beta. An org admin with an active subscription requests access on Settings → Integrations → AI assistant (MCP). AirShop enables your organization when you are approved. See Subscription.
What you can do¶
Read (after your organization is approved and your user has MCP access):
- Find inquiries, quotes, and customers
- Look up inventory items, low stock, procurement sources, and notes
- List open shop issues and production work assigned to you
- Check how much MCP usage you have left
Write needs Read and write on that person, or on their role. They can only change data their role already allows.
With write access, the assistant can:
- Create a shop issue and attach photos
- Add notes and update status on issues and inquiries
- Draft a follow-up email
- Set inventory counts, low quantity, reorder quantity, and item status
- Update procurement source details and notes
- Create an inventory item
Changes made through the assistant show in the activity log with an MCP label.
Request access¶
- Confirm your organization has an active AirShop subscription.
- An org admin opens Settings → Integrations → AI assistant (MCP) and chooses REQUEST ACCESS.
- After AirShop approves your organization, an org admin sets access. See Set MCP access.
- That person opens Settings → Integrations → AI assistant (MCP).
If your organization is approved but you see no connector URL, your user does not have MCP access yet. Ask an org admin to grant Read or Read and write.
Set MCP access¶
An org admin does this after AirShop approves the organization.
Set permissions per user¶
- Open Settings → Users.
- Edit the person.
- Set MCP access to None, Read, or Read and write.
Read looks up data. Read and write can also make changes. They only get what their role already allows.
Set permissions per role¶
- Open Settings → Users and choose Manage Roles.
- Edit the role.
- Under AI assistant (MCP), turn on read, write, or both.
Everyone in that role gets it. The role still limits which data they can see and change.
Connector URL¶
Use this URL in Claude and ChatGPT:
https://airshop.work/api/mcp
The URL is the same for every organization. Access comes from the AirShop account you sign in with. If the assistant asks for a transport, choose Streamable HTTP.
You can also copy the URL from Settings → Integrations → AI assistant (MCP) after your organization is approved.
Claude (desktop, web, mobile)¶
- Open Settings → Connectors and choose Add custom connector.
- Name it AirShop. Paste
https://airshop.work/api/mcp. Pick Streamable HTTP if asked. - Sign in with the AirShop email that has MCP access.
- Approve access on the AirShop consent screen.
ChatGPT¶
- Use a ChatGPT plan that supports custom MCP connectors. Turn on developer mode if ChatGPT requires it.
- Add a connector. Name it AirShop and paste
https://airshop.work/api/mcp. - Sign in with the AirShop email that has MCP access and approve access.
Example requests¶
Read:
- "Find quotes for Acme Fabrication"
- "Which inventory items are low on stock?"
- "Look up the end mill by item code"
- "List open shop-floor issues"
- "What production work is assigned to me?"
- "How much MCP usage do I have left?"
Write (only when your organization and your user have write access):
- "Create a shop issue for the cracked fixture and attach a photo"
- "Add a note to the cracked weld issue"
- "Mark that inquiry as accepted"
- "Draft a follow-up email to this customer"
- "Set this item count to 40, low qty to 6, and reorder qty to 24"
- "Mark that inventory item ORDER NOW"
Usage¶
Calls reset daily. Units reset monthly. Bigger lookups use more units. Your limits and what you have left are on the AI assistant (MCP) page. You can also ask the assistant how much MCP usage you have left.
Troubleshooting¶
Unauthorized
Your organization is not in the beta yet, your subscription is not active, or your user does not have MCP access. Open this page in AirShop and choose Request access, then ask an org admin to set MCP access in Settings → Users.
Limit reached
Check Usage on the AI assistant page, or ask the assistant how much MCP usage you have left. Wait until the daily or monthly limit resets.
Missing tools or data
Your AirShop role may not include that data. Ask an org admin to check your role, and to set MCP access on your user or AI assistant (MCP) on your role. Changes need Read and write.
Wrong account
Disconnect the connector in Claude or ChatGPT, add it again, and sign in with the AirShop user who has MCP access.
