stackgate.ai
Alle integrationer

SendGrid

Læs SendGrid e-mailaktivitet, bounce-suppressions og leveringsstatistik via MCP.

Manual setup 5 værktøjer

Eksempelspørgsmål

Prøv at spørge din AI-klient

  • How did SendGrid delivery look over the last 7 days?

  • Did the receipt email to Jack ever bounce?

  • Which addresses bounced in the last 6 hours?

  • Write a short deliverability brief for Amalie - do not send mail.

  • Find the events for the password-reset message I sent yesterday.

Overblik

Forbind SendGrid, så AI-klienter kan læse transaktionel e-mailaktivitet, bounce-suppressions og leveringsstatistik (leveret, åbninger, klik) via SendGrid v3 API.

Integrationen er read-first. Afsendelse af mail eller sletning af suppressions er ikke inkluderet. Brug den til at bekræfte om en kvittering, password-reset eller marketing-udsendelse blev leveret.

Dette er ikke postkasseadgang. Brug Gmail eller Outlook til det. Brug Email til IMAP/SMTP.

Forudsætninger

  • En SendGrid-konto
  • En API-nøgle med Mail Settings-læseadgang (bounces og statistik)
  • Email Activity History-tilkøb og Email Activity-rettighed til beskedsøgning
  • En stackgate.ai-konto

Sådan får du credentials

  1. Log ind i SendGrid-konsollen.
  2. Åbn Settings → API Keys → Create API Key.
  3. Vælg Restricted Access. Aktivér mindst Email Activity (read) og Mail Settings (read). Aktivér ikke Mail Send.
  4. Kopiér nøglen med det samme. Den starter med SG. og vises kun én gang.
  5. Valgfrit: for at slå op som en subuser skal du kopiere subuser-brugernavnet. stackgate.ai sender det som On-Behalf-Of.
  6. I stackgate.ai: Mine integrationer → SendGrid.
  7. Indsæt API-nøglen. Tilføj kun subuser-brugernavn, hvis værktøjerne skal køre som den subuser.
  8. Gem. stackgate.ai verificerer nøglen mod GET /v3/user/account og gemmer den krypteret.
  9. Brug evt. Edit tool access for kun at tillade læseværktøjer.

Se SendGrid v3 API og Email Activity.

Credentials-reference

Felt Påkrævet Hvor finder du det Noter
API-nøgle Ja Settings → API Keys Starter med SG.; gemmes krypteret
Subuser-brugernavn Nej Settings → Subuser Management Sendes som On-Behalf-Of på alle requests

Rettigheder

Rettighed Hvorfor Adgang
Email Activity (read) list_messages, search_messages, get_message Læs
Mail Settings (read) list_bounces og global get_stats Læs

SendGrid bruger ikke OAuth i denne connect-flow. Foretræk en restricted key uden Mail Send.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/sendgrid med Sanctum bearer token
  • Private gateway: én config til alle integrationer - brug sendgrid__*-navngivne værktøjer

Eksempel-prompter:

  • "Vis SendGrid leveringsstatistik for de seneste 7 dage."
  • "List seneste SendGrid-bounces."
  • "Søg SendGrid-beskeder til billing@example.com med emnet Receipt."
  • "Hent SendGrid-besked abc123 og list events."

Fejlfinding

Problem Sandsynlig årsag Løsning
422 integration not configured Formularen er ikke gemt Udfyld API-nøglen under Mine integrationer
401 Unauthorized Forkert eller roteret nøgle Opret en ny nøgle og opret forbindelsen igen
Ugyldigt API-nøgleformat Nøglen mangler SG.-præfiks Indsæt den fulde nøgle fra Settings → API Keys
403 på list_messages Email Activity-tilkøb eller rettighed mangler Aktivér Email Activity på nøglen, eller brug get_stats og list_bounces
403 på en subuser Forkert brugernavn eller parent-nøgle kan ikke agere for den subuser Bekræft subuser-brugernavnet
429 Too many requests SendGrids burst-grænser Prøv igen efter kort pause og hold limit lav

Sikkerhed og tilbagekaldelse

  • Afbryd SendGrid under Mine integrationer for at slette den gemte API-nøgle fra stackgate.ai.
  • Tilbagekald nøglen i SendGrid Settings → API Keys, hvis du mistænker lækage.
  • Modtageradresser og emner i værktøjsresultater er PII. Foretræk besked-ID, event-type og tal i Slack- eller ticket-opsummeringer.
  • Audit logs registrerer værktøjsnavne og argumenter. Undgå at indsætte rå modtagerlister i offentlige prompts.
  • stackgate.ai krypterer credentials at rest og gemmer ikke beskedindhold, medmindre du kopierer det til Temp Storage.

Begrænsninger

  • Read-only MVP: ingen send, ingen sletning af suppressions, ingen template- eller kampagne-skrivning.
  • list_messages, search_messages og get_message kræver Email Activity-tilkøb.
  • Email Activity-søgning bruger SendGrid-syntaks som to_email="user@example.com" AND subject="Receipt".
  • Stats start_date er påkrævet (YYYY-MM-DD). Bounce-vinduer bruger unix-tidsstempler.
  • List-værktøjer bruger små sider for at begrænse PII i model-kontekst.

Tilgængelige værktøjer

  • list_messages

    List seneste SendGrid Email Activity-beskeder.

  • get_message

    Hent en SendGrid-besked efter ID, inkl. events.

  • search_messages

    Søg i SendGrid Email Activity efter modtager, emne eller status.

  • list_bounces

    List SendGrid bounce-suppressions i et tidsvindue.

  • get_stats

    Hent SendGrid leveringsstatistik for et datointerval.

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

Relaterede workflows

Multi-integrations-playbooks, der bruger SendGrid til konkrete forretningsresultater.

Opret konto Dokumentation