Stockisto har en MCP-server så att en AI-assistent kan hitta butiker som säljer en produkt och, efter inloggning, läsa eller ändra ditt eget konto.
01 Två ändpunkter
| Ändpunkt | Vem | Inloggning | Gräns |
|---|---|---|---|
/mcp | Alla | Ingen | 80 anrop per minut och IP-adress |
/mcp/me | Personal hos varumärken, återförsäljare och installatörer | Din Stockisto-inloggning via OAuth | 120 anrop per minut och användare |
Båda använder Streamable HTTP. Dessa adresser finns på TEST:
https://api.test.stockisto.com/mcp
https://api.test.stockisto.com/mcp/me
Produktionsadressen kommer vid produktionsstart.
02 Anslut assistenten
| Assistent | Steg |
|---|---|
| Claude.ai | Öppna Settings, Connectors, Add custom connector. Klistra in /mcp/me-adressen, välj Connect, logga in och välj Allow. |
| ChatGPT | Aktivera utvecklarläget i anslutningsinställningarna innan du lägger till en egen anslutning. Klistra in /mcp/me-adressen, anslut, logga in och tillåt åtkomst. |
| Claude Code | Kör kommandot nedan. Slutför inloggning och samtycke i webbläsaren. |
| Cursor | Lägg till servern i mcp.json enligt nedan, ladda om och välj Connect i MCP-panelen. Logga in och tillåt åtkomst. |
claude mcp add --transport http stockisto https://api.test.stockisto.com/mcp/me
{
"mcpServers": {
"stockisto": {
"url": "https://api.test.stockisto.com/mcp/me"
}
}
}
Varje assistent registrerar sig själv och markeras därför som overifierad på samtyckessidan. Kontrollera assistentens namn, returadressens värdnamn, ditt namn och ditt företag innan du tillåter åtkomst. Endast läsning (mcp:read) är förvalt. Läsning och skrivning (mcp:write) väljs separat; skrivverktygen visas bara med det samtycket.
03 Verktyg för alla
find_where_to_buy hittar butiker för en produkt eller ett varumärke i Sverige, Norge, Danmark och Finland. Verktyget tar q (produktnamn, artikelnummer, EAN eller varumärke), category, city, country, latitude, longitude, radiusKm (högst 500), inStockOnly och ett sidnummer. Det ger 12 butiker per sida med lagersignal, underlag och observationsdatum.
04 Verktyg efter inloggning
Verktygen följer din roll och ditt samtycke. Ett varumärkeskonto listar aldrig en återförsäljares verktyg. Börja med läsåtkomst och anropa supplier_list_retailers med ett leverantörskonto för att kontrollera ditt eget nätverk.
| Roll | Läsning | Skrivning |
|---|---|---|
| Varumärke | supplier_search_productssupplier_list_stocksupplier_list_retailerssupplier_get_network_summarysupplier_get_retailersupplier_get_funnelsupplier_get_widget_reportsupplier_get_attribution_baselinesupplier_get_outreach_draft | supplier_save_outreach_draft |
| Återförsäljare | retailer_list_store_questionsretailer_get_store_questionretailer_list_store_reviewsretailer_get_store_reviewretailer_list_locations | retailer_update_stockretailer_confirm_stock |
| Installatör | installer_get_my_companyinstaller_list_reviewsinstaller_list_job_requestsinstaller_list_leadsinstaller_get_lead_responsiveness | installer_submit_quote |
supplier_get_widget_report läser din egen widgetaktivitet med filter för datum, artikelnummer, butik, domän och enhet. Perioden är normalt 30 dagar; märkta botar utesluts om inte includeBots är true.
För att spara ett kontaktutkast krävs ett SupplierAdmin-konto och funktionen ai-recommendations. Verktyget sparar ett utkast; det skickar inget meddelande. Ett funktionsavslag kräver funktionsåtkomst, inte ett nytt samtycke. Installatörsverktygen kräver ett godkänt företag. Stockistos operatörsverktyg ingår inte i kundanslutningar.
Skrivverktyg kräver en idempotencyKey. Samma nyckel och argument ger det första resultatet med replayed: true. Ändrade argument med samma nyckel ger idempotency_key_reused. Granska målposten och ändringen innan du använder ett skrivverktyg.
05 Ta bort åtkomst
Öppna Anslutna assistenter i din portal: varumärke, återförsäljare eller installatör. Ta bort assistentens medgivande. Nästa förnyelse nekas; en utfärdad åtkomsttoken kan gälla till sin egen sluttid. Utloggning, lösenordsbyte och en avslutad session kan bryta åtkomsten tidigare. Om anslutningen slutar fungera loggar du in igen och ansluter med rätt konto och behörighet.
06 För en egen MCP-klient
| Steg | Ändpunkt eller krav |
|---|---|
| Upptäckt | OAuth-metadata för skyddad resurs (RFC 9728) och auktorisationsserver (RFC 8414), från API:et |
| Registrering | POST /oauth/register, dynamisk klientregistrering |
| Auktorisering | PKCE med endast S256 |
| Token | POST /oauth/token; förnyelsetoken byts vid användning och återanvändning avslutar medgivandet |
| Återkallelse | POST /oauth/revoke |
Ett internt värdnamn i metadata eller samtyckesinställningar är ett serverkonfigurationsfel. Be din Stockisto-operatör kontrollera den publika API-adressen.
Läs Inställningar för kontots inställningar.
För det publika API:et, läs Utvecklarreferensen. Senaste ändringarna finns i Ändringsloggen.