Spring til hovedindhold
Udvikler- & AI-dokumentationLive · server v1.0.0

Forbind din AI-assistent

Forbind Claude, ChatGPT eller en anden MCP-klient til din kundeportal. Assistenten kan læse dine projekter, fakturaer, supportsager, webstedsstatus og filer. På Pro- og Ultra-planerne kan den også oprette sager eller sende ændringsanmodninger, men kun når du har bekræftet den nøjagtige forhåndsvisning.

Værktøjer og grænser

Hver plan har sine egne grænser. Serveren håndhæver antal nøgler, anmodninger pr. minut pr. nøgle og månedlige enheder for hele kontoen.

Basic

Gratis

Kun læsning. Ingen skrivning på denne plan

NøglerAktive nøgler pr. konto: op til 1
Hastighed30 anmodninger pr. minut pr. nøgle
Kvote1,000 enheder pr. konto pr. måned

Se projekter, fakturaer, supportsager, sitestatus, projektfiler og den månedlige rapport.

Pro

3,000,000 Toman / md.

Læsning og bekræftede skrivninger

NøglerAktive nøgler pr. konto: op til 3
Hastighed60 anmodninger pr. minut pr. nøgle
Kvote5,000 enheder pr. konto pr. måned

Alle læseværktøjer, plus bekræftede skrivninger: åbn og svar på supportsager, send ændringsanmodninger og Farr-beskeder, upload filer, opret og opdater indholdskladder, og accepter eller afvis forslag. Hver skrivning forhåndsvises først og udføres kun, når du har godkendt den.

Ultra

5,000,000 Toman / md.

Alt i Pro, plus massehandlinger og webhooks

NøglerAktive nøgler pr. konto: op til 10
Hastighed120 anmodninger pr. minut pr. nøgle
Kvote20,000 enheder pr. konto pr. måned

Alt i Pro, plus massehandlinger på sager (bulk_ticket_reply, bulk_ticket_close og bulk_actions, op til 20 sager pr. kald), webhooks (webhook_list, webhook_create og webhook_delete) og planlagte månedlige rapporter (scheduled_reports og scheduled_reports_get).

Sikkerhed: Ingen betalings- eller ejerskabshandlinger

Assistentens API har ingen værktøjer til at betale fakturaer, overføre penge, ændre kontoejerskab eller administrere nøgler. Fakturaer er skrivebeskyttede. Betaling udføres af dig i kundeportalen.

Sådan opretter du en assistentnøgle

Opret en nøgle i kundeportalen i tre trin.

1. Log ind på portalen

Log ind på kundeportalen og åbn Assistentadgang i menuen.

2. Opret en nøgle

Klik på "Opret nøgle". Indtast et navn på 3 til 60 tegn (f.eks. "Claude Code - bærbar"), vælg tilladelser og gyldighedsperiode. Oprettelse kræver fornyet login.

3. Kopiér nøglen med det samme

Den fulde nøgle vises kun én gang direkte efter oprettelsen. Serveren gemmer kun et SHA-256-hash af hemmeligheden. Hvis du mister den, skal du tilbagekalde den og oprette en ny.

Sådan forbinder du Claude & ChatGPT

Forbind via MCP Streamable HTTP-protokollen med en Bearer-nøgle eller ved at logge ind med OAuth.

Claude Code og andre MCP-klienter

I værktøjer, der accepterer en server-URL og headers, såsom .mcp.json-filen i Claude Code, tilføjes denne post, hvor pladsholderen erstattes med din nøgle:

{
  "mcpServers": {
    "sajjad-portal": {
      "type": "http",
      "url": "https://sajjad.blog/api/client/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_AGENT_KEY>"
      }
    }
  }
}

ChatGPT og webassistenter

Tilføj denne adresse som en brugerdefineret connector og log ind, når der anmodes om det (OAuth). Nøgle er ikke nødvendig her. Menunavne kan variere.

MCP Server URL
https://sajjad.blog/api/client/mcp
Autorisations-header (nøglebaserede klienter)
Bearer <DIN_ASSISTENTNØGLE>
Two-Step Write Architecture

Hvad "Forhåndsvisning og bekræftelse" betyder for skrivninger

En ændring anvendes aldrig ved det første kald.

Når en assistent kalder et skriveværktøj, gemmer serveren anmodningen og returnerer en forhåndsvisning med et engangstoken, der udløber efter 10 minutter. Ændringen træder først i kraft, når assistenten kalder bekræftelsesværktøjet med dette token efter din godkendelse. Hvert token fungerer kun én gang for den pågældende nøgle og konto. Alle handlinger logges.

Step 1
1. Assistenten udarbejder ændringen
Step 2
2. Du gennemgår forhåndsvisningen og godkender
Step 3
3. Serveren verificerer tokenet og gemmer resultatet

Verificeret værktøjsreference

De vigtigste værktøjer, klientendepunktet tilbyder, samt bekræftelsesværktøjet, der bruges efter en forhåndsvisning. Et værktøj uden for din plan afvises med en plan_required-besked.

VærktøjsnavnAdgangstypeBeskrivelse
projects_listLæsVis op til 50 af dine projekter: kode, navn, status, fremdrift og slutdato.
invoices_listLæsVis op til 25 fakturaer med forfaldsdato, total, betalt beløb, saldo og status. Brug openOnly til kun at se ubetalte. Kladder og betalingslinks udelades altid.
tickets_listLæsVis op til 50 supportsager med status, prioritet og seneste svartidspunkt.
ticket_getLæsHent beskedhistorik for en supportsag (op til 100 beskeder). Interne notater udelades.
ticket_createBekræftet skrivningKlargør en ny supportsag med lav eller normal prioritet. Oprettes først efter godkendelse af forhåndsvisning.
ticket_replyBekræftet skrivningKlargør et svar på en åben sag. Lukkede sager kan ikke besvares. Sendes kun efter bekræftelse.
change_request_createBekræftet skrivningKlargør en ændringsanmodning på et projekt. Anvendes først efter godkendelse af forhåndsvisning.
site_statusLæsViser domænestatus, besøgende og sidevisninger (24 timer og 7 dage), oppetidsprocent og uløste fejl for det tilknyttede site baseret på seneste telemetrisynkronisering.
files_listLæsVis filer i dit projektlager, op til 100 pr. side, eventuelt i en mappe.
file_linkLæsOpret et downloadlink til en gemt fil. Linket udløber efter 15 minutter.
report_monthlyLæsFå et månedligt resumé (op til 12 måneder tilbage): projekter, åbne/lukkede sager, aktuel sitestatus, forfaldne fakturaer og et PDF-link gyldigt i 15 minutter.

Ofte stillede spørgsmål

Almindelige spørgsmål om kundeassistenter, sikkerhed og brugsgrænser.

Kan min AI-assistent betale fakturaer automatisk?

Nej. Assistentens API indeholder ingen værktøjer til betaling eller pengeoverførsel. Fakturaer kan kun læses, og betaling foretages af dig selv i kundeportalen.

Hvad sker der, når jeg når min månedlige enhedskvote?

Hver plan har et månedligt enhedsbudget for hele kontoen. En læsning koster 1 enhed, og en skrivningsforhåndsvisning koster 3. Når kontoens forbrug i måneden når planens budget, returnerer efterfølgende kald en quota_exceeded-fejl i værktøjsresultatet (HTTP 200, ikke 429), indtil den kalendermåned i UTC skifter.

Hvordan tilbagekalder jeg en kompromitteret assistentnøgle?

Åbn Assistentadgang i kundeportalen, vælg Tilbagekald nøgle og bekræft. Efterfølgende anmodninger med denne nøgle afvises med det samme. OAuth-assistenter kan afbrydes fra samme side.

Skal jeg køre en lokal bridge for at forbinde ChatGPT?

Nej. Endepunktet er et almindeligt HTTPS-endepunkt: klienten sender JSON-RPC via POST og modtager JSON. Cloud-baserede assistenter forbinder direkte uden lokal software.

Klar til at sætte din assistent i arbejde?

Vælg en plan for at komme i gang, eller åbn kundeportalen og opret en assistentnøgle.