[{"data":1,"prerenderedAt":311},["ShallowReactive",2],{"changelog:off-route":3,"\u002Fai-assistants":4,"docs-nav":263},null,{"id":5,"title":6,"body":7,"cards":3,"description":249,"extension":250,"group":251,"hero":3,"icon":252,"meta":253,"navTitle":254,"navigation":255,"order":256,"path":257,"seo":258,"sitemap":259,"stem":261,"__hash__":262},"docs\u002Fai-assistants.md","Connect an AI assistant",{"type":8,"value":9,"toc":241},"minimark",[10,14,30,33,44,47,52,94,98,101,107,111,114,212,215,219,228,232,235],[11,12,6],"h1",{"id":13},"connect-an-ai-assistant",[15,16,17,18,22,23,22,26,29],"p",{},"Cargoplot runs an MCP server, so an AI assistant can look things up in Cargoplot\nfor you: ",[19,20,21],"em",{},"which of our shipments to Rotterdam are delayed?",", ",[19,24,25],{},"what does invoice\n2026-0412 cover?",[19,27,28],{},"has the container for our last inquiry left port?"," It uses the\nsame public API as your integrations, as you, and only reads.",[15,31,32],{},"Add it to your assistant with the server URL:",[34,35,41],"pre",{"className":36,"code":38,"language":39,"meta":40},[37],"language-text","https:\u002F\u002Fmcp.cargoplot.com\n","text","",[42,43,38],"code",{"__ignoreMap":40},[15,45,46],{},"You need no token and nothing to install. The assistant sends you to Cargoplot's\nsign-in page, and you approve the connection there.",[48,49,51],"h2",{"id":50},"adding-it","Adding it",[53,54,55,79,85],"ul",{},[56,57,58,62,63,66,67,70,71,74,75,78],"li",{},[59,60,61],"strong",{},"Claude."," Add a custom connector under ",[59,64,65],{},"Customize → Connectors"," and give it\nthe URL. On a Team or Enterprise plan an Owner adds it once, under\n",[59,68,69],{},"Organization settings",", for everyone. In Claude Code, run\n",[42,72,73],{},"claude mcp add --transport http cargoplot https:\u002F\u002Fmcp.cargoplot.com"," and sign\nin with ",[42,76,77],{},"\u002Fmcp",".",[56,80,81,84],{},[59,82,83],{},"ChatGPT."," Turn on developer mode and add the URL as a connector.",[56,86,87,90,91,78],{},[59,88,89],{},"Other MCP clients."," Anything that speaks MCP over Streamable HTTP and signs in\nwith OAuth works the same way. The server publishes where to sign in at\n",[42,92,93],{},"https:\u002F\u002Fmcp.cargoplot.com\u002F.well-known\u002Foauth-protected-resource",[48,95,97],{"id":96},"signing-in","Signing in",[15,99,100],{},"The first time a tool is used, the assistant opens Cargoplot's sign-in page. Sign\nin with your Cargoplot account and approve the request to access Cargoplot on your\nbehalf. The assistant keeps the connection until you remove it.",[102,103,104],"note",{},[15,105,106],{},"Sign in to the Cargoplot app itself at least once before connecting an assistant.\nAn account the assistant is the first to use is refused, with a message saying so.",[48,108,110],{"id":109},"what-it-can-do","What it can do",[15,112,113],{},"The assistant reads what you can read in the app, for your own organization:",[115,116,117,130],"table",{},[118,119,120],"thead",{},[121,122,123,127],"tr",{},[124,125,126],"th",{},"Tool",[124,128,129],{},"What it returns",[131,132,133,147,157,170,183,196],"tbody",{},[121,134,135,144],{},[136,137,138,22,141],"td",{},[42,139,140],{},"list_shipments",[42,142,143],{},"get_shipment",[136,145,146],{},"Your shipments, one or a page at a time, searchable by reference, container, vessel, port or city",[121,148,149,154],{},[136,150,151],{},[42,152,153],{},"get_shipment_tracking",[136,155,156],{},"A shipment's tracking events, per container at sea or per shipment by air",[121,158,159,167],{},[136,160,161,22,164],{},[42,162,163],{},"list_shipment_documents",[42,165,166],{},"list_shipment_invoices",[136,168,169],{},"What is attached to a shipment",[121,171,172,180],{},[136,173,174,22,177],{},[42,175,176],{},"list_invoices",[42,178,179],{},"get_invoice",[136,181,182],{},"Your invoices",[121,184,185,193],{},[136,186,187,22,190],{},[42,188,189],{},"list_inquiries",[42,191,192],{},"get_inquiry",[136,194,195],{},"Your inquiries",[121,197,198,209],{},[136,199,200,22,203,22,206],{},[42,201,202],{},"get_user",[42,204,205],{},"get_profile_user",[42,207,208],{},"get_profile_organization",[136,210,211],{},"You, your colleagues and your organization",[15,213,214],{},"It cannot change anything: it raises, updates and cancels nothing, and it cannot\ndownload document or invoice files. It answers in pages of 20, and asks for more\nwhen it needs them.",[48,216,218],{"id":217},"limits","Limits",[15,220,221,222,227],{},"An assistant's calls count against ",[223,224,226],"a",{"href":225},"\u002Frate-limits","your rate limit",", the same one\nyour access tokens share. A long conversation that looks through many shipments\ncan reach it; the assistant is told when to try again.",[48,229,231],{"id":230},"disconnecting","Disconnecting",[15,233,234],{},"Remove the connector in your assistant. Its sign-in stops working within the\nhour, when the access it holds expires, and connecting again asks you to sign in\nand approve it anew.",[236,237,238],"warning",{},[15,239,240],{},"Your assistant's provider sees what the tools return, as it sees anything else you\nshare in a conversation. Connect only an assistant your company allows for its\nshipping data.",{"title":40,"searchDepth":242,"depth":242,"links":243},2,[244,245,246,247,248],{"id":50,"depth":242,"text":51},{"id":96,"depth":242,"text":97},{"id":109,"depth":242,"text":110},{"id":217,"depth":242,"text":218},{"id":230,"depth":242,"text":231},"Let Claude, ChatGPT or another MCP client read your shipments, tracking, documents, invoices and inquiries for you.","md","getting-started","mdi-robot-outline",{},"AI assistants",true,3,"\u002Fai-assistants",{"title":6,"description":249},{"loc":257,"lastmod":260},"2026-09-27","ai-assistants","AxVQi2UmmEuzNd7ZS2haXKgjgenQ_bSoLdOXvXLIJMM",[264,269,273,274,281,286,290,295,300,305],{"path":265,"title":266,"navTitle":266,"icon":267,"group":251,"order":268},"\u002F","Overview","mdi-book-open-page-variant-outline",1,{"path":270,"title":271,"navTitle":3,"icon":272,"group":251,"order":242},"\u002Fauthentication","Authentication","mdi-key-variant",{"path":257,"title":6,"navTitle":254,"icon":252,"group":251,"order":256},{"path":275,"title":276,"navTitle":277,"icon":278,"group":279,"order":280},"\u002Finquiries","Creating and updating inquiries","Inquiries","mdi-file-document-edit-outline","working",4,{"path":282,"title":283,"navTitle":3,"icon":284,"group":279,"order":285},"\u002Ftracking","Shipment tracking","mdi-map-marker-path",5,{"path":225,"title":287,"navTitle":3,"icon":288,"group":279,"order":289},"Rate limits","mdi-speedometer",6,{"path":291,"title":292,"navTitle":3,"icon":293,"group":279,"order":294},"\u002Fpagination","Pagination and filtering","mdi-filter-variant",7,{"path":296,"title":297,"navTitle":3,"icon":298,"group":279,"order":299},"\u002Ferrors","Errors","mdi-alert-outline",8,{"path":301,"title":302,"navTitle":3,"icon":303,"group":279,"order":304},"\u002Fglossary","Glossary","mdi-book-alphabet",9,{"path":306,"title":307,"navTitle":3,"icon":308,"group":309,"order":310},"\u002Fversioning","Versioning","mdi-tag-outline","current",10,1790752580572]