Siirry pääsisältöön
Kehittäjä- ja tekoälydokumentaatioKäytössä · palvelin v1.0.0

Yhdistä tekoälyavustajasi

Yhdistä Claude, ChatGPT tai muu MCP-asiakas asiakasportaaliisi. Avustaja voi lukea projektisi, laskusi, tukipyyntösi, sivuston tilan ja tiedostosi. Pro- ja Ultra-tasoilla se voi myös avata tukipyyntöjä tai lähettää muutospyyntöjä, mutta vain kun vahvistat tarkan esikatselun.

Työkalut ja rajoitukset

Jokainen taso asettaa omat rajansa. Palvelin valvoo avainten määrää, pyyntöjä minuutissa avainta kohden ja kuukausittaisia yksiköitä koko tilille.

Basic

Ilmainen

Vain luku. Kirjoitukset eivät ole käytössä tällä tasolla

AvaimetAktiiviset avaimet tiliä kohden: enintään 1
Nopeus30 pyyntöä minuutissa avainta kohden
Kiintiö1,000 yksikköä tiliä kohden kuukaudessa

Tarkastele projekteja, laskuja, tukipyyntöjä, sivuston tilaa, projektitiedostoja ja kuukausiraporttia.

Pro

3,000,000 Toman / kk

Luku ja vahvistetut kirjoitukset

AvaimetAktiiviset avaimet tiliä kohden: enintään 3
Nopeus60 pyyntöä minuutissa avainta kohden
Kiintiö5,000 yksikköä tiliä kohden kuukaudessa

Kaikki lukutyökalut sekä vahvistetut kirjoitukset: tukipyyntöjen avaaminen ja vastaaminen, muutospyyntöjen ja Farr-viestien lähettäminen, tiedostojen lataaminen, sisältöluonnosten luominen ja päivittäminen sekä ehdotusten hyväksyminen tai hylkääminen. Jokainen kirjoitus esikatsellaan ensin ja otetaan käyttöön vasta, kun hyväksyt sen.

Ultra

5,000,000 Toman / kk

Kaikki Pro-tason toiminnot sekä massatoiminnot ja webhookit

AvaimetAktiiviset avaimet tiliä kohden: enintään 10
Nopeus120 pyyntöä minuutissa avainta kohden
Kiintiö20,000 yksikköä tiliä kohden kuukaudessa

Kaikki Pro-tason toiminnot sekä tukipyyntöjen massatoiminnot (bulk_ticket_reply, bulk_ticket_close ja bulk_actions, enintään 20 pyyntöä kutsua kohden), webhookit (webhook_list, webhook_create ja webhook_delete) ja ajastetut kuukausiraportit (scheduled_reports ja scheduled_reports_get).

Turvallisuus: Ei maksu- tai omistustoimintoja

Avustajan API:ssa ei ole työkaluja laskujen maksamiseen, varojen siirtämiseen, tilin omistajuuden muuttamiseen tai avainten hallintaan. Laskut ovat vain luku -tilassa. Maksut suoritetaan asiakasportaalissa.

Avustaja-avaimen luominen

Luo avain asiakasportaalissa kolmessa vaiheessa.

1. Kirjaudu portaaliin

Kirjaudu asiakasportaaliin ja avaa valikosta Avustajan käyttöoikeus.

2. Luo avain

Napsauta "Luo avain". Anna 3–60 merkin pituinen nimi (esim. "Claude Code - kannettava"), valitse oikeudet ja voimassaoloaika. Luonti vaatii uuden kirjautumisen.

3. Kopioi avain heti talteen

Täydellinen avain näytetään vain kerran heti luomisen jälkeen. Palvelin tallentaa vain salaisen osan SHA-256-tiivisteen. Jos kadotat sen, mitätöi se ja luo uusi.

Clauden ja ChatGPT:n yhdistäminen

Yhdistä MCP Streamable HTTP -protokollalla käyttäen Bearer-avainta tai OAuth-kirjautumista.

Claude Code ja muut MCP-asiakasohjelmat

Lisää palvelimen URL-osoitteen ja otsikot hyväksyviin työkaluihin (kuten Claude Coden .mcp.json-tiedostoon) tämä merkintä ja korvaa paikkamerkki avaimellasi:

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

ChatGPT ja verkkoavustajat

Lisää tämä osoite mukautettuna yhdistimenä ja kirjaudu pyydettäessä (OAuth). Tässä menetelmässä avainta ei tarvita.

MCP-palvelimen URL
https://sajjad.blog/api/client/mcp
Valtuutusotsake (avainpohjaiset asiakkaat)
Bearer <AVUSTAJA_AVAIN>
Two-Step Write Architecture

Mitä "Esikatsele ja vahvista" tarkoittaa kirjoitustoiminnoissa

Muutosta ei koskaan sovelleta suoraan ensimmäisellä kutsulla.

Kun avustaja kutsuu kirjoitustyökalua, palvelin tallentaa pyynnön ja palauttaa esikatselun sekä 10 minuuttia voimassa olevan kertakäyttöisen vahvistustunnisteen. Muutos toteutuu vasta, kun avustaja kutsuu vahvistustyökalua kyseisellä tunnisteella suostumuksesi jälkeen. Jokainen tunniste toimii vain kerran ja samalle tilille.

Step 1
1. Avustaja luo muutosehdotuksen
Step 2
2. Tarkistat esikatselun ja hyväksyt
Step 3
3. Palvelin vahvistaa tunnisteen ja tallentaa tuloksen

Vahvistettujen työkalujen hakemisto

Asiakasrajapinnan tärkeimmät työkalut sekä esikatselun jälkeen käytettävä vahvistustyökalu. Tasosi ulkopuolella oleva työkalu hylätään plan_required-viestillä.

Työkalun nimiKäyttöoikeusToiminnon kuvaus
projects_listLukuListaa enintään 50 projektiasi: koodi, nimi, tila, edistyminen ja päättymispäivä.
invoices_listLukuListaa enintään 25 laskua eräpäivän, loppusumman, maksetun summan ja tilan mukaan. openOnly näyttää vain avoimet. Luonnokset ja maksulinkit on jätetty pois.
tickets_listLukuListaa enintään 50 tukipyyntöäsi tilan, prioriteetin ja viimeisimmän vastauksen mukaan.
ticket_getLukuHae tukipyynnön viestihistoria (enintään 100 viestiä). Sisäiset muistiinpanot on suljettu pois.
ticket_createVahvistettava kirjoitusValmistele uusi tukipyyntö matalalla tai normaalilla prioriteetilla. Luodaan vasta esikatselun vahvistuksen jälkeen.
ticket_replyVahvistettava kirjoitusValmistele vastaus avoimeen pyyntöön. Suljettuihin pyyntöihin ei voi vastata. Lähetetään vain vahvistettuna.
change_request_createVahvistettava kirjoitusValmistele muutosehdotus projektiisi. Sovelletaan vasta esikatselun vahvistamisen jälkeen.
site_statusLukuNäyttää yhdistetyn sivuston verkkotunnuksen tilan, kävijät ja sivulataukset (24h ja 7pv), käytettävyysprosentin ja avoimet virheet viimeisimmän telemetrian mukaan.
files_listLukuListaa projektitallennustilan tiedostot, enintään 100 sivua kohden, valinnaisesti kansion alta.
file_linkLukuLuo latauslinkki tallennettuun tiedostoon. Linkki vanhenee 15 minuutin kuluttua.
report_monthlyLukuHae kuukausikooste (enintään 12 kuukautta taaksepäin): projektit, tukipyynnöt, sivuston tila, laskut ja 15 minuuttia voimassa oleva PDF-linkki.

Usein kysytyt kysymykset

Yleisiä kysymyksiä avustajista, tietoturvasta ja käyttörajoutuksista.

Voiko tekoälyavustajani maksaa laskuja automaattisesti?

Ei voi. Avustajan API:ssa ei ole työkaluja laskujen maksamiseen tai varojen siirtoon. Laskut ovat vain katseltavissa, ja maksut hoidetaan asiakasportaalissa.

Mitä tapahtuu, kun saavutan kuukausittaisen kiintiöni?

Jokaisella tasolla on kuukausittainen yksikköbudjetti koko tilille. Luku maksaa 1 yksikön ja kirjoituksen esikatselu 3 yksikköä. Kun tilin kuukausikäyttö saavuttaa tason budjetin, seuraavat kutsut palauttavat työkalun tuloksessa virheen quota_exceeded (HTTP 200, ei 429), kunnes UTC-kalenterikuukausi vaihtuu.

Miten mitätöin vaarantuneen avustaja-avaimen?

Avaa asiakasportaalissa Avustajan käyttöoikeus, valitse Mitätöi avain ja vahvista. Kaikki myöhemmät pyynnöt hylätään välittömästi. OAuth-avustajat voidaan katkaista samalta sivulta.

Tarvitseeko minun suorittaa paikallinen siltasovellus yhdistääkseni ChatGPT:n?

Ei tarvitse. Päätepiste on normaali HTTPS-osoite: asiakas lähettää JSON-RPC-viestejä POST-pyynnöllä ja vastaanottaa JSON-vastauksen. Pilviavustajat yhdistyvät suoraan ilman paikallisia ohjelmistoja.

Oletko valmis ottamaan avustajan käyttöön?

Valitse sopiva tilaus tai avaa asiakasportaali ja luo avustaja-avain.