stackgate.ai
Log ind Opret profil
Alle integrationer

Purelymail

Forbind Claude, ChatGPT eller Cursor til Purelymail via MCP. Administrer domæner, postkasser, routing-regler og kontokredit med et API-token.

Manual setup 19 værktøjer

Eksempelspørgsmål

Prøv at spørge din AI-klient

  • How much Purelymail credit is left on this account?

  • Which Purelymail domains are failing DNS checks?

  • List the mailbox users on example.com.

  • Show the routing rules for example.com.

  • Draft a plan to add support@example.com as an alias - do not create it until I confirm.

Overblik

Forbind Purelymail, så AI-klienter kan administrere domæner, postkassebrugere, routing-regler, password-reset-metoder, app-adgangskoder og forudbetalt kredit - uden at lime API-tokenet ind i prompts.

Integrationen administrerer Purelymail-kontoen. Den læser eller sender ikke mail.

Forudsætninger

  • En Purelymail-konto
  • En stackgate.ai-konto
  • Et API-token fra Purelymail-kontoportalen

Sådan får du credentials

  1. Log ind på Purelymail-kontoportalen.
  2. Åbn kontoen og klik Refresh API Key. Opdatering erstatter det forrige token. Kopiér det nye token med det samme.
  3. I stackgate.ai: åbn Mine integrationer → Purelymail.
  4. Klik Activate, indsæt API-tokenet, og gem. stackgate.ai tester tokenet med Purelymail checkAccountCredit, før det gemmes.

Se Purelymail API-referencen.

Credentials-reference

Felt Påkrævet Hvor finder du det Bemærkninger
API-token Ja Kontoportal → Refresh API Key Sendes som headeren Purelymail-Api-Token. Gemmes krypteret.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/purelymail med et Sanctum bearer-token
  • Privat gateway: én konfiguration til alle integrationer - brug purelymail__*-værktøjer
  • Business-gateway: samme navngivne værktøjer, når Purelymail er aktiveret for virksomheden

Vigtige værktøjer:

  • check_account_credit, list_domains, get_ownership_code - kredit, domæner og DNS-ejerskabs-TXT
  • list_users, get_user, create_user - create_user tager local part plus domain_name; get, modify og delete tager den fulde adresse
  • list_routing_rules, create_routing_rule, delete_routing_rule - aliasser og catch-alls; delete bruger routing_rule_id
  • add_domain, update_domain_settings, delete_domain - add bruger domain_name; indstillinger og delete bruger name
  • create_app_password, delete_app_password - hemmeligheden returneres én gang; delete skal bruge den hemmelighed, ikke et id

Destruktive værktøjer: modify_user (adgangskodeskift), delete_user, delete_password_reset, delete_routing_rule, delete_domain og delete_app_password. Bekræft med brugeren, før de kaldes. delete_domain fjerner også domænets brugere.

Efter forbindelsen kan du bruge Edit tool access til at begrænse værktøjer (for eksempel kun læsning, ingen sletninger).

Se Dokumentation for HTTP-autentificering og opsætning af privat gateway.

Test integrationen

Hvor meget Purelymail-kredit er der tilbage på kontoen?
Hvilke domæner fejler DNS-tjek?
List postkassebrugere på example.com.
Vis routing-regler for example.com.

Typiske værktøjer: check_account_credit, list_domains, list_users, list_routing_rules.

Fejlsøgning

Problem Sandsynlig årsag Løsning
422 integration not configured Credential-formularen er ikke udfyldt Tilføj API-tokenet under Mine integrationer
Purelymail afviste tokenet, eller invalidToken Tokenet er opdateret eller tilbagekaldt Klik Refresh API Key i kontoportalen og gem det nye token
HTTP 200 med type: error Purelymail rapporterer fejl inde i et vellykket HTTP-svar Læs code og message. Hubben behandler type: error som et fejlet værktøjskald
list_users ser ufuldstændig ud API'et returnerer højst 1000 adresser Afgræns spørgsmålet til ét domæne; loftet ligger hos Purelymail
add_domain fejler DNS Ownership-TXT mangler, eller DNS er ikke propageret Kald get_ownership_code, publicér TXT, og tilføj derefter domænet. Efter en senere DNS-rettelse: kald update_domain_settings med recheck_dns true og derefter list_domains
App-adgangskode kan ikke slettes via id Delete kræver hemmeligheden Brug hemmeligheden fra create_app_password

Sikkerhed og tilbagekaldelse

  • Afbryd under Mine integrationer → Purelymail for at slette det gemte token fra stackgate.ai.
  • Klik Refresh API Key i Purelymail-kontoportalen for at ugyldiggøre det forrige token.
  • Hubben gemmer API-tokenet krypteret. Den gemmer ikke postkasseindhold, postkasseadgangskoder eller app-adgangskoder. Værktøjskald audit-logges. Tokenet accepteres aldrig som værktøjsargument.

Begrænsninger

  • Mail læses eller sendes ikke via denne integration.
  • list_users returnerer højst 1000 adresser.
  • create_user bruger local part i user_name. Andre brugerværktøjer bruger den fulde adresse.
  • add_domain bruger domain_name. update_domain_settings og delete_domain bruger name.
  • delete_routing_rule bruger routing_rule_id, ikke id.
  • create_routing_rule med prefix false er et præcist local-part-match.
  • App-adgangskoder vises én gang af Purelymail. Delete skal bruge den hemmelighed.

Tilgængelige værktøjer

  • check_account_credit

    Returnér Purelymail-kontoens kredit som en decimalstreng.

  • list_domains

    List domæner på Purelymail-kontoen, inklusive DNS-status. Sæt include_shared for at medtage delte domæner.

  • get_ownership_code

    Hent DNS TXT-værdien, der beviser ejerskab, før add_domain.

  • list_users

    List postkasseadresser på Purelymail-kontoen. API'et returnerer højst 1000 adresser.

  • get_user

    Hent én postkassebruger på den fulde adresse, inkl. reset-metoder og sikkerhedsflag. Returnerer ikke adgangskoden.

  • list_routing_rules

    List routing-regler (aliasser og catch-alls) på Purelymail-kontoen.

  • list_password_reset_methods

    List password-reset-metoder (recovery-mail eller telefon) for én postkassebruger.

  • create_user

    Opret en postkassebruger. user_name er kun local part, ikke den fulde adresse.

  • modify_user

    Ændr en postkassebruger. Destruktiv: new_password erstatter den nuværende adgangskode. user_name er den fulde adresse.

  • delete_user

    Slet en postkassebruger permanent. Destruktiv. user_name er den fulde adresse.

  • upsert_password_reset

    Opret eller erstat en password-reset-metode (email eller phone) for en postkassebruger.

  • delete_password_reset

    Fjern en password-reset-metode permanent. Destruktiv.

  • create_routing_rule

    Opret et routing-regel. Sæt prefix til false for et præcist local-part-match.

  • delete_routing_rule

    Slet et routing-regel permanent via routing_rule_id. Destruktiv.

  • add_domain

    Tilføj et domæne, der allerede består Purelymails DNS-tjek. Publicér ownership-TXT først.

  • update_domain_settings

    Opdatér indstillinger for et ejet domæne. Feltet er name, ikke domainName. Sæt recheck_dns for at tjekke DNS igen.

  • delete_domain

    Slet et domæne og dets brugere permanent. Destruktiv. Feltet er name, ikke domainName.

  • create_app_password

    Opret en app-adgangskode. Hemmeligheden returneres én gang og gemmes ikke i hubben.

  • delete_app_password

    Slet en app-adgangskode permanent. Destruktiv. Kræver selve hemmeligheden, ikke et id.

MCP-endpoint: https://stackgate.ai/mcp/purelymail (HTTP) eller via private gateway.

Opret konto Dokumentation