MCP

Ühenda AI-agent MCP kaudu

Model Context Protocoli server, mis ühendab MCP kliendid olemasoleva projektivõtmega päris Postline API-ga.

Laadi alla OpenAPI 3.1

Mis see on

Postline'i majutatud MCP server asub aadressil https://api.srs-postline.com/mcp ning pakub tüübitud tööriistu e-kirjade, domeenide, tõkestuste ja webhookide jaoks.

Enne koodi kirjutamist

  • Küsi kasutajalt projekti API-võti või lase tal luua sandbox-võti aadressil https://app.srs-postline.com/et/login — ära kunagi leiuta, arva ega taaskasuta teise projekti võtit.
  • Pane võti serveripoolsesse keskkonnamuutujasse. Ära pane seda frontend-koodi, mobiilirakenduse pakki, avalikku repositooriumisse ega commititud .env-faili.
  • Alusta srs_test_ võtmega sandbox-projektis. Sandbox saab saata ainult kasutaja kinnitatud saajatele, seega tegelik postkasti toimetamine vajab ülevaadatud live-projekti — ära luba live-saatmise toimimist enne selle ülevaatuse lõppu.
  • Loe /llms.txt ja openapi/postline.yaml enne päringukoodi genereerimist; ära arva väljade nimesid ega lõpp-punkte.

Ühendamine

Ühenda majutatud endpoint Postline Bearer-võtmega; allalaadimist ega kohalikku build'i pole vaja.

claude mcp add --scope user --transport http postline \
  https://api.srs-postline.com/mcp \
  --header "Authorization: Bearer srs_live_xxx"

export POSTLINE_API_KEY='srs_live_xxx'
codex mcp add postline --url https://api.srs-postline.com/mcp \
  --bearer-token-env-var POSTLINE_API_KEY

Kontrollid enne iga saatmist

  • Saada alati Idempotency-Key, mis on tuletatud käivitavast toimingust (tellimuse ID, sündmuse ID), et kordussaatmised ei saadaks sõnumit topelt.
  • Ära kunagi pane OTP-koode, parooli lähtestamise tokeneid ega muid saladusi väljale, mida logitakse või edastatakse väljapoole sõnumi sisu.
  • Küsi kitsaimat API-võtme õiguste ulatust, mida ülesanne vajab (saatmiseks piisab emails:send-ist; ära küsi domains:write ega api_keys:write, kui ülesanne seda ei nõua).
  • Piira saajate arv 100-ni kõne kohta. Praegune API ei aktsepteeri manuseid ega kohandatud päiseid; lükka fail tagasi või jaga linki, väitmata, et fail lisati manusena.
  • Ära korda vaikimisi 4xx vastuste puhul. Ainult 429 ja 503 on turvaline korrata, ja seda ainult viivitusega (backoff).

Käsitle iga vastusekoodi

  • 202 — järjekorda lisatud, mitte kohale toimetatud. Salvesta tagastatud id, kui pead hiljem olekut kontrollima.
  • 400 — vigane päring (payload); paranda päring, ära korda muutmata kujul.
  • 401 — vigane või aegunud võti; peata ja anna sellest kasutajale teada, ära leiuta uut võtit.
  • 403 — puudub õiguste ulatus või saatev domeen ei ole veel kinnitatud; palu kasutajal domeen enne jätkamist kinnitada.
  • 409 — idempotentsuse konflikt; käsitle algset päringut juba saadetuna.
  • 422 — saaja on mahasurutud (varasem bounce/complaint); ära korda saatmist sellele saajale.
  • 429 — kiiruspiirang; oota ja proovi hiljem uuesti, ära tsükli kiirelt.
  • 503 — järjekord ei ole saadaval; proovi uuesti viivitusega, ära lülitu mitteametlikule edastusviisile.

Masinloetavad viited

  • /llms.txt — nende reeglite kokkuvõtlik indeks agendi kontekstiakna jaoks.
  • /openapi/postline.yaml — kõigi lõpp-punktide täielik OpenAPI 3.1 skeem.
  • /et/api/ — inimloetav API teatmik.
  • /et/webhooks/ — webhooki signatuuri ja korduskatsete üksikasjad.