Pliing.
NorskEnglish

MCP · PRIVAT BETA

Pliing MCP

La AI-assistenten varsle underveis og be om et valg i Pliing.

Koble til AI-assistenten

  1. Opprett et prosjekt og koble til din PliingID. Godkjenn varsler under Avsendere i appen.
  2. Åpne prosjektet i konsollen. Under «AI-varsler med MCP» velger du godkjent mottaker og lager en navngitt MCP-nøkkel. Kopier den når den vises.
  3. Legg til en ekstern MCP-server i AI-klienten med innstillingene nedenfor. Lagre nøkkelen i klientens sikre innstillinger eller miljøoppsett.
  4. Be assistenten sende fremdrift, varsle ved fullføring/feil og bruke Pliing når den trenger svar. Behold request_id mens du venter på svar.
TransportStreamable HTTP
Adressehttps://api.pliing.app/mcp
AuthorizationBearer <din MCP-nøkkel>

Denne versjonen bruker manuelt konfigurert Bearer-tilgang. Klienter som bare støtter OAuth-innlogging i nettleser trenger en senere OAuth-integrasjon. Legg aldri nøkkelen i chatten. For et personlig app-prosjekt kan du sende mcp_recipient med egen PliingID til det eksisterende endepunktet for prosjektnøkler; vanlige sendernøkler får ikke tilgang til MCP.

Codex og Claude Code

Lag en egen MCP-nøkkel for hver klient. Gjør PLIING_CODEX_MCP_TOKEN tilgjengelig for Codex-prosessen og PLIING_CLAUDE_MCP_TOKEN tilgjengelig for Claude Code før de starter. Kommandoene nedenfor lagrer variabelnavn, ikke hemmelighetene. Start klienten på nytt eller koble til på nytt etter oppsett. Også Codex-appen må ha tilgang til sin variabel; en variabel satt i en annen terminal oppdaterer ikke en app som allerede kjører.

Codex

codex mcp add pliing --url https://api.pliing.app/mcp \
  --bearer-token-env-var PLIING_CODEX_MCP_TOKEN

Tilsvarende i config.toml:

[mcp_servers.pliing]
url = "https://api.pliing.app/mcp"
bearer_token_env_var = "PLIING_CODEX_MCP_TOKEN"

Claude Code

claude mcp add --transport http --scope user pliing \
  https://api.pliing.app/mcp \
  --header 'Authorization: Bearer ${PLIING_CLAUDE_MCP_TOKEN}'

Tilsvarende i .mcp.json:

{
  "mcpServers": {
    "pliing": {
      "type": "http",
      "url": "https://api.pliing.app/mcp",
      "headers": {
        "Authorization": "Bearer ${PLIING_CLAUDE_MCP_TOKEN}"
      }
    }
  }
}

Offisiell Codex-dokumentasjon · Offisiell Claude Code-dokumentasjon

Forslag til instruksjon

Bruk Pliing til å varsle meg ved nyttige milepæler, fullføring og feil. Når du trenger et valg, kall pliing_ask, behold request_id og hent pliing_get_response med angitt mellomrom. Fortsett først etter et uttrykkelig svar som tillater den konkrete handlingen. Ventende, utløpt, feil og tidsavbrudd er aldri godkjenning. Følg klientens egne godkjenningskrav.

Tre verktøy

VerktøyVirkemåte
pliing_notifySender fremdrift, resultat eller feil. Påkrevd: title, body, idempotency_key. Valgfritt: level (info/important/critical), url og url_label for en HTTPS-lenke til resultatet.
pliing_askStiller et spørsmål med 2–3 valg. Hvert valg har en stabil value og en label på brukerens språk. Returnerer en varig request_id.
pliing_get_responseHenter status og valgt svar. Påkrevd: request_id. Ventende og utløpt betyr aldri godkjenning.

Mottakeren er låst av nøkkelen. Verktøyene har ikke noe «to»-argument. Accepted betyr lagret hos Pliing, ikke bekreftet levering eller lesing.

Statuseksempel: argumenter til pliing_notify

{
  "title": "Bygg ferdig",
  "body": "Alle tester er grønne.",
  "idempotency_key": "build-42-complete",
  "url": "https://ci.example.org/build/42",
  "url_label": "Åpne resultat"
}

Spør, vent og fortsett

Kompatible klienter forhandler MCP automatisk. Curl-eksemplene bruker den støttede protokollen 2025-11-25 for en manuell test.

curl https://api.pliing.app/mcp \
  -H "Authorization: Bearer $PLIING_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pliing_ask",
    "arguments": {
      "title": "Skal jeg fortsette?",
      "body": "Testene er grønne. Skal jeg rulle ut bygg 42?",
      "choices": [
        {
          "value": "continue",
          "label": "Fortsett"
        },
        {
          "value": "cancel",
          "label": "Avbryt"
        }
      ],
      "idempotency_key": "build-42-question",
      "context": "build-42",
      "expires_in_seconds": 900
    }
  }
}'

Verktøyresultatet inneholder dette objektet i structuredContent:

{
  "request_id": "94876911-92e1-4fa2-bb9c-a57018dc0af0",
  "status": "pending",
  "answer": null,
  "context": "build-42",
  "expires_at": "2026-10-19T12:15:00+00:00",
  "answered_at": null,
  "poll_after_seconds": 5
}

Mottakeren åpner varselet i Pliing og trykker ett valg. Hent svaret i et senere MCP-kall:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "pliing_get_response",
    "arguments": {
      "request_id": "94876911-92e1-4fa2-bb9c-a57018dc0af0"
    }
  }
}

Når status er answered, inneholder answer valgt verdi og tekst, for eksempel {"value":"continue","label":"Fortsett"}. Fortsett bare i tråd med valget og AI-klientens egne godkjenningskrav. Hent ventende svar med minst fem sekunders mellomrom. Stopp ved besvart eller utløpt.

Grenser og virkemåte

← API-dokumentasjon