Hoppa till huvudinnehållet
Utvecklar- & AI-dokumentationAktiv · server v1.0.0

Anslut din AI-assistent

Anslut Claude, ChatGPT eller en annan MCP-klient till din kundportal. Assistenten kan läsa dina projekt, fakturor, supportärenden, webbplatsstatus och filer. På Pro- och Ultra-planerna kan den också öppna ärenden eller skicka ändringsbegäran, men bara efter att du har bekräftat den exakta förhandsvisningen.

Verktyg och gränser

Varje plan har egna gränser. Servern tillämpar antalet nycklar, anrop per minut per nyckel och månatliga enheter för hela kontot.

Basic

Kostnadsfri

Endast läsning. Inga skrivningar på den här planen

NycklarAktiva nycklar per konto: upp till 1
Hastighet30 anrop per minut per nyckel
Kvot1,000 enheter per konto och månad

Visa projekt, fakturor, supportärenden, webbplatsstatus, projektfiler och månadsrapporten.

Pro

3,000,000 Toman / mån

Läsning och bekräftade skrivningar

NycklarAktiva nycklar per konto: upp till 3
Hastighet60 anrop per minut per nyckel
Kvot5,000 enheter per konto och månad

Alla läsverktyg, plus bekräftade skrivningar: öppna och svara på supportärenden, skicka ändringsbegäran och Farr-meddelanden, ladda upp filer, skapa och uppdatera innehållsutkast samt acceptera eller avvisa förslag. Varje skrivning förhandsvisas först och tillämpas bara när du har godkänt den.

Ultra

5,000,000 Toman / mån

Allt i Pro, plus massåtgärder och webhooks

NycklarAktiva nycklar per konto: upp till 10
Hastighet120 anrop per minut per nyckel
Kvot20,000 enheter per konto och månad

Allt i Pro, plus massåtgärder på ärenden (bulk_ticket_reply, bulk_ticket_close och bulk_actions, upp till 20 ärenden per anrop), webhooks (webhook_list, webhook_create och webhook_delete) och schemalagda månadsrapporter (scheduled_reports och scheduled_reports_get).

Säkerhet: Inga betalnings- eller ägarskapsåtgärder

Assistentens API har inga verktyg för att betala fakturor, överföra pengar, ändra kontoägarskap eller hantera nycklar. Fakturor är skrivskyddade. Betalning görs direkt av dig i kundportalen.

Hur du skapar en assistentnyckel

Skapa en nyckel i kundportalen i tre steg.

1. Logga in på portalen

Logga in på kundportalen och öppna Assistentåtkomst i menyn.

2. Skapa en nyckel

Klicka på "Skapa nyckel". Ange ett namn på 3 till 60 tecken (t.ex. "Claude Code - laptop"), välj behörigheter och giltighetstid. Skapandet kräver förnyad inloggning.

3. Kopiera nyckeln direkt

Hela nyckeln visas endast en gång direkt efter att den har skapats. Servern sparar bara en SHA-256-hash av hemligheten. Om du tappar bort den, återkalla den och skapa en ny.

Hur du ansluter Claude & ChatGPT

Anslut via MCP Streamable HTTP-protokollet med en Bearer-nyckel eller genom inloggning med OAuth.

Claude Code och andra MCP-klienter

I verktyg som accepterar server-URL och rubriker, till exempel .mcp.json-filen i Claude Code, lägger du till den här posten och ersätter platshållaren med din nyckel:

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

ChatGPT och webbassistenter

Lägg till denna adress som en anpassad anslutning och logga in när du uppmanas (OAuth). Ingen nyckel behövs här. Menynamn kan variera mellan assistenter.

MCP Server URL
https://sajjad.blog/api/client/mcp
Auktoriseringsrubrik (nyckelbaserade klienter)
Bearer <DIN_ASSISTENTNYCKEL>
Two-Step Write Architecture

Vad "Förhandsgranska, sedan bekräfta" innebär för skrivningar

En ändring tillämpas aldrig vid det första anropet.

När en assistent anropar ett skrivverktyg sparar servern begäran och returnerar en förhandsgranskning med en engångsbekräftelsetoken som löper ut efter 10 minuter. Ändringen tillämpas först när assistenten anropar bekräftelseverktyget med denna token efter ditt godkännande. Varje token fungerar en enda gång för den nyckel och det konto som skapade den. Alla förberedda åtgärder loggas.

Step 1
1. Assistenten utarbetar ändringen
Step 2
2. Du granskar förhandsvisningen och godkänner
Step 3
3. Servern validerar token och sparar resultatet

Verifierad verktygsreferens

De viktigaste verktygen som klientendpunkten erbjuder, plus bekräftelseverktyget som används efter en förhandsvisning. Ett verktyg utanför din plan nekas med ett plan_required-meddelande.

VerktygsnamnÅtkomsttypFunktionsbeskrivning
projects_listLäsaLista upp till 50 av dina projekt: kod, namn, status, framsteg och slutdatum.
invoices_listLäsaLista upp till 25 fakturor med förfallodatum, totalbelopp, betalat belopp, saldo och status. Använd openOnly för att se obetalda. Utkast och betalningslänkar utesluts.
tickets_listLäsaLista upp till 50 supportärenden med status, prioritet och senaste svarstid.
ticket_getLäsaHämta meddelandehistorik för ett supportärende (upp till 100 meddelanden). Interna anteckningar utesluts.
ticket_createBekräftad skrivningFörbered ett nytt supportärende med låg eller normal prioritet. Skapas först efter att förhandsvisningen bekräftats.
ticket_replyBekräftad skrivningFörbered ett svar på ett öppet ärende. Stängda ärenden kan inte besvaras. Skickas först efter bekräftelse.
change_request_createBekräftad skrivningFörbered en ändringsförfrågan för ett projekt. Tillämpas först efter att förhandsvisningen bekräftats.
site_statusLäsaVisar domänstatus, besökare och sidvisningar (24 timmar och 7 dagar), drifttidsprocent och olösta fel för den anslutna webbplatsen baserat på senaste telemetrisynk.
files_listLäsaLista filer i projektlagringen, upp till 100 per sida, eventuellt i en mapp.
file_linkLäsaSkapa en nedladdningslänk för en sparad fil. Länken löper ut efter 15 minuter.
report_monthlyLäsaFå en månadssammanfattning (upp till 12 månader tillbaka): projekt, öppna/stängda ärenden, webbplatsögonblicksbild, förfallna fakturor och en PDF-länk giltig i 15 minuter.

Vanliga frågor och svar

Vanliga frågor om klientassistenter, säkerhet och användningsgränser.

Kan min AI-assistent betala fakturor automatiskt?

Nej. Assistentens API saknar verktyg för betalning eller överföring av pengar. Fakturor kan endast läsas, och betalning görs direkt i kundportalen av dig själv.

Vad händer när jag når min månatliga enhetskvot?

Varje plan har en månatlig enhetsbudget för hela kontot. En läsning kostar 1 enhet och en skrivförhandsvisning 3. När kontots användning under månaden når planens budget returnerar efterföljande anrop ett quota_exceeded-fel i verktygsresultatet (HTTP 200, inte 429) tills UTC-kalendermånaden byter.

Hur återkallar jag en komprometterad assistentnyckel?

Öppna Assistentåtkomst i kundportalen, välj Återkalla nyckel och bekräfta. Alla efterföljande förfrågningar med den nyckeln avvisas omedelbart. OAuth-anslutna assistenter kan kopplas från på samma sida.

Måste jag köra en lokal brygga för att ansluta ChatGPT?

Nej. Slutpunkten är en vanlig HTTPS-adress: klienten skickar JSON-RPC via POST och tar emot JSON. Molnbaserade assistenter ansluter direkt utan lokal programvara.

Redo att sätta din assistent i arbete?

Välj ett abonnemang för att komma igång eller öppna kundportalen och skapa en assistentnyckel.