Installera SosoAPI: paket, klienter och fjärransluten MCP

Vilket npm-paket ska jag installera?

Installera sosoapi för en ny konfiguration. Paketen @sosoapi/cli, sosoapi-cli och sosoapi-mcp är alias som installerar exakt samma version av sosoapi. De kör samma CLI- och MCP-verktyg, så du behöver bara ett paket.

Lokal MCP kräver Node.js 20 eller senare och npm/npx. Värdbaserad MCP behöver inget lokalt paket. Logga in efter installation eller anslutning för att ge åtkomst till dina konton.

• sosoapi
• @sosoapi/cli
• sosoapi-cli
• sosoapi-mcp

Anslut en lokal MCP-klient

Använd kommandona nedan för att lägga till en anslutning med profilen core. Om SosoAPI redan är anslutet och fungerar behåller du den anslutningen. Att köra sosoapi utan argument startar stdio MCP-servern; den väntar på klienten via stdin.

För Claude Desktop, Cursor eller en annan stdio-klient lägger du till JSON nedan i MCP-inställningarna. Inställningarnas plats och godkännandesteg varierar mellan klienter. Starta om eller återanslut klienten vid behov och kontrollera sedan att SosoAPI-verktygen finns i konversationen.

claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}

• MCP-verktygsreferens

Anslut fjärr-MCP med OAuth

Lägg till URL:en nedan i en klient som stöder fjärransluten MCP, OAuth och dynamisk klientregistrering. Logga in i webbläsaren och välj vilka arbetsytor och åtgärder du vill tillåta. Du behöver inte klistra in API-nyckel, klient-ID eller klienthemlighet. För medier via HTTP importerar du en offentlig URL; lokal filuppladdning kräver den lokala MCP-servern.

Egna appar i ChatGPT och fjärranslutningar i Claude beror på ditt abonnemang och klientens tillgängliga anslutningsinställningar. Instruktionerna konfigurerar en egen anslutning; de beskriver ingen appkataloglistning.

https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp

• Autentisering och behörigheter

Verifiera konfiguration utan publicering

Kontrollera autentiseringsstatus och logga in vid behov. Läs arbetsytekontext och anslutna konton och bekräfta sedan att returnerat konto och arbetsyta är de avsedda. Detta verifierar åtkomst utan att skicka in ett inlägg; publicering beror fortfarande på kontots behörigheter.

Du behöver inte publicera ett testinlägg för att slutföra konfigurationen. Fortsätt din ursprungliga uppgift med dess befintliga innehåll. Användaren slutför leverantörssamtycket och granskar destination, innehåll och tid före varje begärd skrivning.

npx sosoapi auth status

npx sosoapi api contract --route /identity-api/workspace/list --summary

Uppdatera eller lås en version

Kör npx -y sosoapi@latest --help för att hämta aktuell CLI och starta sedan om MCP-klienten. Om klienten har ett sparat kommando anger du önskad version i dess args. Alias är bundna till sin exakta sosoapi-version; att uppdatera en separat global installation uppdaterar dem inte.

Om du ser ett versionsavvikelsefel, jämför installerat kontrakt med den åtgärd du behöver. Uppdatera paketet i kommandot som MCP-klienten faktiskt använder, anslut igen och prova åtgärden på nytt. En schemaavvikelse kräver inte nya autentiseringsuppgifter eller bredare åtkomst.

npx -y sosoapi@latest --help

npx sosoapi api contract --summary

• Felsökning