Anslut en AI-assistent

Utvecklardokumentation: alla sidor

Börja

Hjälp och dokumentation

Ändringar

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

ÄndpunktVemInloggningGräns
/mcpAllaIngen80 anrop per minut och IP-adress
/mcp/mePersonal hos varumärken, återförsäljare och installatörerDin Stockisto-inloggning via OAuth120 anrop per minut och användare

Båda använder Streamable HTTP. Dessa adresser finns på TEST:

Adresser · TEST
https://api.test.stockisto.com/mcp
https://api.test.stockisto.com/mcp/me

Produktionsadressen kommer vid produktionsstart.

02 Anslut assistenten

AssistentSteg
Claude.aiÖppna Settings, Connectors, Add custom connector. Klistra in /mcp/me-adressen, välj Connect, logga in och välj Allow.
ChatGPTAktivera 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 CodeKör kommandot nedan. Slutför inloggning och samtycke i webbläsaren.
CursorLägg till servern i mcp.json enligt nedan, ladda om och välj Connect i MCP-panelen. Logga in och tillåt åtkomst.
Terminal · Claude Code
claude mcp add --transport http stockisto https://api.test.stockisto.com/mcp/me
JSON · Cursor mcp.json
{
    "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.

RollLäsningSkrivning
Varumärkesupplier_search_products
supplier_list_stock
supplier_list_retailers
supplier_get_network_summary
supplier_get_retailer
supplier_get_funnel
supplier_get_widget_report
supplier_get_attribution_baseline
supplier_get_outreach_draft
supplier_save_outreach_draft
Återförsäljareretailer_list_store_questions
retailer_get_store_question
retailer_list_store_reviews
retailer_get_store_review
retailer_list_locations
retailer_update_stock
retailer_confirm_stock
Installatörinstaller_get_my_company
installer_list_reviews
installer_list_job_requests
installer_list_leads
installer_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äcktOAuth-metadata för skyddad resurs (RFC 9728) och auktorisationsserver (RFC 8414), från API:et
RegistreringPOST /oauth/register, dynamisk klientregistrering
AuktoriseringPKCE med endast S256
TokenPOST /oauth/token; förnyelsetoken byts vid användning och återanvändning avslutar medgivandet
ÅterkallelsePOST /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.