AI-agents via MCP met TrekMail verbinden

Met de TrekMail MCP-server kunnen compatibele AI-clients je e-mailinfrastructuur beheren via natuurlijke taal. De catalogus omvat domeinen, mailboxen, White Label-branding en teams, Drive, e-mail, agenda, migraties, ondersteuning, facturering en verwante diensten via dezelfde TrekMail API.

De volledige catalogus wordt niet in elk gesprek geladen. TrekMail stelt tools/list samen op basis van de actieve referentie: tools buiten de scopes worden weggelaten, net als tools die zijn uitgesloten door een geselecteerde toolset, alleen-lezenmodus, transportbeperkingen of een lokale veiligheidsinstelling. Een e-mailreferentie met beperkte scopes toont daarom een compacte lijst met e-mailtools.

Kies hoe je verbinding wilt maken

Routes 1-3 gebruiken OAuth 2.1: wanneer je voor het eerst verbinding maakt, opent je browser de toestemmingspagina van TrekMail, controleer je de gevraagde rechten en ontvangt de client een token met scopes voor je account. Er wordt geen langdurig tm_live_-token naar de client gekopieerd. Trek een verbinding op elk moment in via AI-agents en API → Tokens → Verbonden apps.

Wat je krijgt

• Een verbindingsspecifieke toolset, vóór registratie gefilterd op de rechten en veiligheidsinstellingen van de huidige verbinding.
• OAuth 2.1 + dynamische clientregistratie: je AI-client registreert zichzelf, leidt je door een toestemmingspagina in de browser en ontvangt een token met beperkte scopes. Voor de web-, desktop- en CLI-routes hoef je geen langdurige tokens te kopiëren en plakken.
• Architectuur met twee tokens: een apart operationeel token voor infrastructuur en een berichttoken voor alle webmailbewerkingen. Wanneer je via OAuth verbindt, worden berichttokens zo nodig automatisch per mailbox aangemaakt.
• Automatische idempotentie voor bewerkingen die dit vereisen, zodat een nieuwe poging dezelfde bewerking niet herhaalt.
• Verwijdering in twee stappen: voor het verwijderen van een mailbox zijn expliciete intentie en bevestiging nodig, waarna de mailbox naar Onlangs verwijderd gaat voor herstel.
• Veiligheidscontroles voor zelfhosting: een beheerder die een eigen stdio MCP-server uitvoert, kan goedkeuring vereisen voor verwijder-, verzend- en migratiebewerkingen.
• Volledige auditregistratie: elke API- en MCP-bewerking wordt 90 dagen bewaard in het logboek.

Voordat je begint

• Alle abonnementen kunnen agents verbinden.
  • Nano: tools voor Email Verifier. Door Drive Storage toe te voegen krijgt de agent ook de Drive-mogelijkheden waarop het account recht heeft, waaronder bladeren, uploaden, delen, herstellen en definitief verwijderen.
  • Starter: volledige Drive, volledige Email Verifier en alleen-lezen toegang tot de overige onderdelen (domeinen, mailboxen, migraties, tickets en meer). Gebruik het dashboard voor schrijfbewerkingen die Starter niet via de API beschikbaar stelt, zoals migraties maken, tickets beantwoorden of het automatische antwoord wijzigen.
  • Pro / Agency: volledige lees- en schrijftoegang binnen elke familie.
  • White Label-proefperiode of add-on: voegt tools voor branding, klanten/teams en activiteit toe zolang het recht actief is. Zonder dit recht worden die schema's weggelaten. Tijdens de opzegtermijn behoudt alleen de eigenaar de leestools.
• Eerste keer? De knop Rondleiding starten op de pagina AI-agents en API doorloopt het verbinden van een agent, de stappen per client, handmatige tokens, verbonden apps en het auditlogboek.
• Voor de OAuth-routes (1, 2, 3) hoef je niet handmatig een token te maken. Je client maakt het aan via de autorisatiestroom in de browser. Maak voor de zelfgehoste stdio-route (4) eerst een tm_live_-token in het dashboard.

1. Externe MCP-client (aanbevolen)

Gebruik deze route wanneer je AI-client externe MCP-servers en browserautorisatie ondersteunt.

Snelkoppeling: op het tabblad Agent verbinden van de pagina AI-agents en API kies je welke client je gebruikt, waarna het exacte pad, het menupad of het configuratiebestand voor die client wordt getoond, samen met een kant-en-klaar fragment waarin je adres al is opgenomen. Staat je client in de lijst, volg dan die instructies in plaats van de algemene stappen hieronder.

1. Open de instellingen voor MCP, integraties of connectors in je client.
2. Kies Externe MCP-server toevoegen of Aangepaste connector toevoegen. Het exacte label verschilt per client.
3. Voer in:
   • Naam: TrekMail
   • URL externe MCP-server: https://trekmail.net/mcp
4. Bevestig de verbinding. Je browser opent de autorisatiepagina van TrekMail.
5. Meld je aan, controleer de gevraagde rechten en keur de toegang goed. Ga terug naar de client wanneer de browser de verbinding bevestigt.

De eerste autorisatie verstrekt een tijdelijk token. Compatibele clients vernieuwen dit automatisch. Gebruik de verbreekactie van de client om de verbinding te beëindigen of trek de app in via Tokens → Verbonden apps in TrekMail.

2. CLI- of desktopclient

Gebruik voor een client die een stdio-opdracht accepteert de onderstaande clientneutrale brug:

npx -y mcp-remote https://trekmail.net/mcp

Configureer die opdracht als MCP-server in je client. Bij de eerste verbinding wordt je browser geopend voor autorisatie.

Sommige clients bieden ook een eigen opdracht om een externe MCP-server toe te voegen. Dat werkt even goed; gebruik https://trekmail.net/mcp als server-URL en volg de aanwijzingen van de client.

Clientspecifiek voorbeeld: Claude Code

claude mcp add trekmail https://trekmail.net/mcp -t http

Clientspecifiek voorbeeld: Claude Desktop

Bewerk je configuratiebestand (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json) en voeg het volgende toe:

{
  "mcpServers": {
    "trekmail": {
      "url": "https://trekmail.net/mcp",
      "transport": "http"
    }
  }
}

Start Claude Desktop opnieuw. De eerste keer dat je TrekMail in een chat noemt, wordt het OAuth-venster geopend.

Clientspecifiek voorbeeld: Cursor

Cursor heeft geen scherm voor een externe server. Het leest ~/.cursor/mcp.json (of .cursor/mcp.json binnen een project):

{
  "mcpServers": {
    "trekmail": {
      "url": "https://trekmail.net/mcp"
    }
  }
}

Clientspecifiek voorbeeld: Windsurf

Windsurf leest ~/.codeium/windsurf/mcp_config.json. Let op: de sleutel is serverUrl, niet url; een externe server die met url is geconfigureerd, wordt genegeerd:

{
  "mcpServers": {
    "trekmail": {
      "serverUrl": "https://trekmail.net/mcp"
    }
  }
}

Sla het bestand op en start de client opnieuw zodat de wijziging wordt opgepikt. Bij de eerste verbinding wordt je browser geopend om toegang goed te keuren.

3. mcp-remote (CLI)

mcp-remote is handig voor tests of niet-Anthropic MCP-clients die externe OAuth-servers nog niet rechtstreeks ondersteunen. Het is een kleine Node-brug van stdio naar externe HTTP.

npx -y mcp-remote https://trekmail.net/mcp

Bij de eerste uitvoering wordt je browser geopend voor OAuth. Daarna wordt het token in ~/.mcp-auth/ opgeslagen en automatisch gebruikt.

Je kunt dit met elke stdio MCP-client verbinden door deze naar de opdracht mcp-remote te verwijzen in plaats van naar een lokaal Node-toegangspunt.

4. Zelfgehoste stdio (Claude Desktop / Docker / npm)

Wil je statische tm_live_-tokens gebruiken in plaats van OAuth (bijvoorbeeld voor onbeheerde servers, privé-instanties van TrekMail of containerimplementaties), kloon dan het stdio MCP-pakket en voer het op je eigen host uit.

Maak eerst een API-token op de pagina AI-agents en API → Tokens. Maak voor het lezen/verzenden van e-mail ook via de API een berichttoken met je operationele token (zie het tabblad Agent verbinden voor instructies).

De MCP-server installeren

git clone https://github.com/trekmail/mcp-server trekmail-mcp
cd trekmail-mcp
npm install
npm run build

Claude Desktop (stdio)

Voeg dit toe aan het MCP-configuratiebestand van Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "trekmail": {
      "command": "node",
      "args": ["./trekmail-mcp/build/index.js"],
      "env": {
        "TREKMAIL_BASE_URL": "https://trekmail.net",
        "TREKMAIL_API_TOKEN": "tm_live_your_token",
        "TREKMAIL_MESSAGE_TOKEN": "tm_msg_your_token",
        "TREKMAIL_ALLOW_SENDING": "false",
        "TREKMAIL_ALLOW_MIGRATION": "false"
      }
    }
  }
}

Werk het pad bij args bij zodat het verwijst naar de locatie waar je de repository hebt gekloond. Vervang de tokens door je eigen tokens. Je kunt TREKMAIL_MESSAGE_TOKEN weglaten als je alleen infrastructuurtools nodig hebt, of TREKMAIL_API_TOKEN weglaten als je alleen berichttools nodig hebt. Er is ten minste één token vereist.

Claude Code (stdio)

Voeg dit toe aan je MCP-instellingen voor Claude Code (.claude/settings.json of de configuratie op projectniveau):

{
  "mcpServers": {
    "trekmail": {
      "command": "node",
      "args": ["./trekmail-mcp/build/index.js"],
      "env": {
        "TREKMAIL_BASE_URL": "https://trekmail.net",
        "TREKMAIL_API_TOKEN": "tm_live_your_token",
        "TREKMAIL_MESSAGE_TOKEN": "tm_msg_your_token",
        "TREKMAIL_ALLOW_SENDING": "false",
        "TREKMAIL_ALLOW_MIGRATION": "false"
      }
    }
  }
}

Docker

Als je de voorkeur geeft aan Docker, bouw dan de image vanuit de repository en voer deze uit:

git clone https://github.com/trekmail/mcp-server trekmail-mcp
cd trekmail-mcp
docker build -t trekmail-mcp .

docker run -i \
  -e TREKMAIL_BASE_URL=https://trekmail.net \
  -e TREKMAIL_API_TOKEN=tm_live_your_token \
  -e TREKMAIL_MESSAGE_TOKEN=tm_msg_your_token \
  -e TREKMAIL_ALLOW_SENDING=false \
  -e TREKMAIL_ALLOW_MIGRATION=false \
  trekmail-mcp

Lokale npm (ontwikkeling)

git clone https://github.com/trekmail/mcp-server trekmail-mcp
cd trekmail-mcp
npm install && npm run build

TREKMAIL_BASE_URL=https://trekmail.net \
TREKMAIL_API_TOKEN=tm_live_your_token \
TREKMAIL_MESSAGE_TOKEN=tm_msg_your_token \
TREKMAIL_ALLOW_SENDING=false \
TREKMAIL_ALLOW_MIGRATION=false \
npm start

Stdio-omgevingsvariabelen

Deze instellingen gelden alleen voor het zelfgehoste stdio MCP-proces dat je uitvoert. Ze schakelen geen TrekMail-productfunctie in of uit.

Drive-tools voor agents

Met een operationeel token dat Drive-scopes bevat, biedt de MCP-server tools voor ruimtes, gebruik, bladeren, uploads, bestanden, mappen, Prullenbak, bulkbewerkingen, openbare deellinks, wachtwoordbeheer voor synchronisatieapparaten en de status van de Drive Add-on. Je verbinding ziet de tools die door de scopes zijn toegestaan.

Stel voor een agent die alleen Drive gebruikt TREKMAIL_API_TOKEN in en geef uitsluitend de scopes die de workflow nodig heeft. Houd destructieve acties uitgeschakeld wanneer je zelfgehoste stdio gebruikt, tenzij de agent een gecontroleerde taak voor definitief verwijderen of het legen van de prullenbak uitvoert. Aanschaf, formaatwijziging en opzegging van de Drive Add-on zijn geen MCP-tools; agents kunnen de add-onstatus en prijzen lezen, maar factureringswijzigingen blijven in het dashboard.

Zie Overzicht van MCP-tools voor Drive en AI-agents verbinden met TrekMail Drive.

Beschikbare tools

De MCP-server stelt deze tools beschikbaar aan verbonden agents. Tools worden voorwaardelijk geregistreerd op basis van de verstrekte tokens.

Welke tools een agent daadwerkelijk kan zien wordt bepaald door drie factoren, die allemaal worden toegepast voordat tools/list antwoordt:

1. De scopes van je token. Een tool waarvan de mogelijkheid niet in je token is opgenomen, wordt nooit geregistreerd.
2. Lokale stdio-veiligheidscontroles. Wanneer je de zelfgehoste stdio-server uitvoert, kan de beheerder goedkeuring vereisen voor schrijf-, verzend- of migratiebewerkingen. Gehoste MCP gebruikt in plaats daarvan de scopes die tijdens OAuth zijn goedgekeurd.
3. TREKMAIL_READ_ONLY=true, waarmee elke schrijftool wordt verwijderd, ongeacht scopes en vlaggen.

Een zelfgehoste verbinding kan dus bewust worden beperkt, zelfs wanneer het token ruimere scopes heeft. Gehoste MCP blijft beperkt tot de tijdens OAuth goedgekeurde rechten.

Domeintools (operationeel token)

Zie Domeinaliassen via API en MCP voor het gedrag per abonnement, antwoordstatussen, veilig verwijderen en routeringsregels voor alleen ontvangen.

White Label-tools (operationeel token)

De toolset white_label bevat 20 tools en verschijnt alleen wanneer het accountrecht, het huidige lidmaatschap en de scopes van de referentie dit toestaan. Branding wordt per domein ingesteld; de overige tools beheren de configuratie, klanten, teamtoegang en activiteit. Voor schrijfbewerkingen is actieve White Label vereist. Tijdens de opzegtermijn behoudt alleen de eigenaar de leestools.

Een agent kan de merkinstellingen van begin tot eind uitvoeren: het merk instellen, de geretourneerde dns_records kopiëren, deze publiceren met apply_cloudflare_dns en daarna de status verifiëren en controleren. Aanroepen die de toegang wijzigen, worden begrensd door het actieve lidmaatschap en de domeingrens van de aanroeper, zelfs als het token ruimere scopes heeft aangevraagd. Zie de Handleiding voor White Label Branding via API en MCP en White Label-teams beheren met API en MCP.

DNS-tools (operationeel token)

Mailboxtools (operationeel token)

Tools voor gedeelde mailboxen (operationeel token)

Een gedeelde mailbox is een teaminbox (support@, sales@) die leden openen via hun eigen reguliere mailboxaccount in Webmail en, indien ingeschakeld, via gedelegeerde native IMAP-/SMTP-toegang. De mailbox heeft geen rechtstreekse aanmelding met wachtwoord. De toegang is vlak: iedereen kan lezen en can_send is de enige schakelaar (kan antwoorden of alleen lezen). Er zijn geen ledenrollen.

Levenscyclus van gedeelde mailboxen (operationeel token)

De drie levenscyclustools en de drie schrijftools voor leden wijzigen de toegang. Een lokaal gehoste stdio-beheerder kan TREKMAIL_ALLOW_DESTRUCTIVE=true vereisen voordat ze beschikbaar zijn; list_shared_mailbox_members is alleen-lezen en altijd beschikbaar.

Roep na het maken, omzetten of wijzigen van het lidmaatschap get_mail_client_setup aan met de id van een reguliere ledenmailbox. Lees shared_mailboxes.items[], wacht op native_access_ready=true en controleer send_as_ready voordat je verzending configureert. Het antwoord bevat de exacte paden voor Inbox/Verzonden/Archief/Ongewenst en bewerkingsvlaggen; SMTP slaat de gedeelde kopie in Verzonden niet op. Een opnieuw te proberen fout native_access_sync_failed bij het verwijderen of bijwerken van rechten of bij een omzetting betekent dat de service bewust de vorige status heeft behouden.

Sieve-tools (operationeel token)

Verwijdertools (operationeel token)

Migratietools (operationeel token)

Tickettools (operationeel token)

Tools voor SMTP / domeinroutering (operationeel token)

SMTP wordt per domein ingesteld: elk domein verwijst naar beheerde verzending via het platform of naar een opgeslagen SMTP-profiel (je eigen provider, herbruikbaar voor meerdere domeinen), terwijl één accountbrede standaard bepaalt waarmee nieuwe domeinen beginnen.

De bovenstaande schrijf- en testtools wijzigen instellingen of voeren een verbindingstest uit. Een lokaal gehoste stdio-beheerder kan TREKMAIL_ALLOW_DESTRUCTIVE=true vereisen voordat ze beschikbaar zijn; get_domain_smtp, list_domain_smtp_profiles, get_domain_smtp_test_status en get_account_smtp_default zijn alleen-lezen en altijd beschikbaar.

Verouderde SMTP-tools (afgeraden)

Deze tools op accountniveau blijven beschikbaar voor achterwaartse compatibiliteit, maar beheren niet langer de routering per domein: gebruik in plaats daarvan de bovenstaande tools voor domeinroutering.

Tools voor spamstatistieken (operationeel token)

Accounttools (operationeel token)

Beheer van berichttokens (operationeel token)

Berichttools (berichttoken)

Het berichttoken ontgrendelt 62 tools voor het volledige webmailoppervlak, inclusief verbonden externe accounts. De tools zijn ingedeeld per functiegebied.

Gehoste OAuth en lokale stdio identificeren de mailbox op verschillende manieren. Bij gehoste HTTP MCP bevat elk schema voor berichttools een verplichte mailbox_id; de server gebruikt deze om een kortdurend token voor die mailbox uit te geven. Bij lokale stdio MCP is TREKMAIL_MESSAGE_TOKEN al aan één mailbox gekoppeld, waardoor diezelfde tools geen mailbox_id accepteren. Een verbonden inbox vormt een tweede selectieniveau: geef external_account_id door naast mailbox_id bij gehoste MCP, of naast het gekoppelde berichttoken bij stdio.

Zeven van de 62 berichttools beheren verbonden accounts en vijf beheren afzenderidentiteiten en antwoordbeleid. Gebruik beide families voor een Gmail-achtige workflow waarin een agent een verbonden Gmail-inbox leest, maar verzendt vanaf een geautoriseerd zakelijk adres via een domeinroute of opgeslagen SMTP-profiel. Zie Verzenden-als-adressen via API en MCP.

Kernberichten

Als voor de mailbox een standaard-CC of standaard-BCC is ingesteld onder Instellingen → Profiel, wordt deze toegevoegd aan wat send_message en schedule_message verzenden, net als bij e-mail die in de webapp wordt geschreven; een adres dat al in het bericht staat, wordt niet nogmaals toegevoegd. Geef apply_default_recipients: false door om dit voor één bericht uit te schakelen. Dit geldt niet voor e-mail die via SMTP vanuit een desktop- of mobiele e-mailclient wordt verzonden, omdat die nooit door de API gaat. | report_spam | Een bericht als spam rapporteren, naar Ongewenst verplaatsen en het filter trainen | | report_ham | Een bericht in Ongewenst als legitiem markeren, naar Inbox verplaatsen en het filter trainen | | bulk_action | Een actie (lezen, ster, verwijderen, verplaatsen, spam) tegelijk toepassen op maximaal 50 berichten |

Mappen

Bijlagen

Concepten

Beide retourneren de uid en uidvalidity van het concept. Bewaar dit paar samen: update_draft vereist het tijdperk zodat een oude, hergebruikte UID nooit een ander bericht kan verwijderen nadat de map Concepten opnieuw is gemaakt. Een concept dat met list_messages is gevonden, moet eerst worden geopend met read_message, dat de huidige uidvalidity retourneert. Een update retourneert een nieuw paar en de oude UID werkt niet meer. Op een server zonder UIDPLUS kunnen beide waarden null zijn, ook al is een nieuw concept opgeslagen; vernieuw Concepten en open het concept voordat je het bijwerkt.

Beide accepteren ook een optionele idempotency_key. Laat je deze weg, dan wordt elke aanroep als nieuw beschouwd en levert tweemaal opslaan van hetzelfde concept dus twee concepten op. Geef dezelfde sleutel door wanneer je een aanroep opnieuw probeert die mogelijk al is uitgevoerd; je krijgt dan het eerste resultaat terug in plaats van een duplicaat.

Gepland verzenden

Contacten

Contactgroepen

Agenda

Compositiehulpmiddelen

Deze tools bereiden de gegevens voor een antwoord of doorgestuurd bericht voor. Ze verzenden niets. Geef de geretourneerde gegevens rechtstreeks door aan send_message of save_draft.

Identiteiten (afzenderadressen)

Sjablonen

Geblokkeerde afzenders

Email Verifier-tools (operationeel token)

Email Verifier-tools zijn beschikbaar bij alle abonnementen, inclusief Nano. Alleen je creditsaldo vormt een beperking.

Cloudflare-tools (operationeel token)

Cloudflare-tools zijn beschikbaar bij de abonnementen Pro en Agency.

Veiligheidscontroles voor zelfgehoste stdio

Wanneer je zelf de stdio MCP-server uitvoert, bepaalt TREKMAIL_ALLOW_DESTRUCTIVE of dat lokale proces verwijderingen en andere schrijfbewerkingen toestaat. Stel dit alleen in op true als je erop vertrouwt dat de agent mailboxverwijdering veilig afhandelt. Deze instelling verandert niets aan de beschikbaarheid van functies in gehoste TrekMail.

Zelfs wanneer destructieve bewerkingen zijn ingeschakeld, vereist verwijderen altijd twee stappen en moet de agent expliciet confirm: true instellen. Zie Veiligheidsbarrières en verwijderintenties voor details.

Veiligheidsbarrières voor verzenden

De tools send_message en schedule_message hebben twee onafhankelijke veiligheidsbarrières waaraan beide moet worden voldaan:

1. Omgevingsbarrière: TREKMAIL_ALLOW_SENDING=true moet zijn ingesteld wanneer de MCP-server wordt gestart.
2. Barrière per aanroep: de agent moet bij elke aanroep confirm_send=true als parameter doorgeven.

Dit ontwerp met twee barrières voorkomt onbedoelde e-mailverzending vanuit een zelfgehost proces. Stel TREKMAIL_ALLOW_SENDING=false in wanneer je agent alleen berichten mag lezen. list_scheduled werkt zonder deze controle; deze geldt alleen voor het maken of verzenden van geplande berichten.

Veiligheidsbarrières voor migraties

Schrijftools voor migratie (start_migration, retry_migration, delete_migration, delete_bulk_migration, update_bulk_migration_job_password, test_migration_connection, preview_bulk_migration, start_bulk_migration, retry_bulk_migration) hebben twee onafhankelijke veiligheidsbarrières:

1. Omgevingsbarrière: TREKMAIL_ALLOW_MIGRATION=true moet zijn ingesteld wanneer de MCP-server wordt gestart.
2. Barrière per aanroep: elke tool vereist een eigen bevestigingsparameter (confirm_start=true, confirm_retry=true of confirm_delete=true).

cancel_migration, cancel_bulk_migration en resume_bulk_migration zijn altijd beschikbaar, ongeacht de zelfgehoste omgevingscontrole, omdat het veiligheids- of hervattingsbewerkingen zijn. Ze vereisen nog steeds bevestigingsparameters per aanroep.

Alleen-lezen migratietools (list_migrations, get_migration, list_bulk_migrations, get_bulk_migration) werken zonder barrières.

Snelle oplossingen

• Agent kan geen verbinding maken: controleer of het pad build/index.js klopt en of je na het klonen npm run build hebt uitgevoerd.
• Fouten "Missing bearer token": controleer of ten minste één van TREKMAIL_API_TOKEN of TREKMAIL_MESSAGE_TOKEN is ingesteld.
• Alleen-lezen tools werken, maar schrijfbewerkingen mislukken: je token hoort bij een Starter-abonnement. Drive-schrijfbewerkingen werken met Starter (volledig Drive-oppervlak). Stap voor andere schrijfbewerkingen, mailboxinrichting, het starten van migraties of het beantwoorden van tickets over op Pro, of gebruik het dashboard.
• Verwijdertools geven fouten bij zelfgehoste stdio: stel TREKMAIL_ALLOW_DESTRUCTIVE=true in de omgeving van dat MCP-proces in. Dit geldt voor verwijderingen en andere schrijfbewerkingen, waaronder berichten, mappen, contacten, agenda, identiteiten, sjablonen, geblokkeerde afzenders en geplande berichten.
• Een verzendtool in zelfgehoste stdio retourneert "Sending is disabled": stel TREKMAIL_ALLOW_SENDING=true in de omgeving van dat MCP-proces in.
• Verzendtool retourneert "Send not confirmed": de agent moet confirm_send=true doorgeven bij elke aanroep van send_message of schedule_message.
• Er verschijnen geen berichttools: zorg dat TREKMAIL_MESSAGE_TOKEN is ingesteld met een geldig tm_msg_-token.
• Schrijftools voor migratie in zelfgehoste stdio geven fouten: stel TREKMAIL_ALLOW_MIGRATION=true in de omgeving van dat MCP-proces in.
• 503 bij het starten van een migratie: de server heeft de migratiecapaciteit bereikt. Probeer het over enkele minuten opnieuw.
• Downloaden van bijlagen mislukt: bijlagen worden als base64 geretourneerd. Grote bijlagen (tot 25 MB) kunnen enkele seconden duren. download_all_attachments retourneert een base64-gecodeerd ZIP-bestand met alle bijlagen.
• Concept verdween na bijwerken: update_draft verwijdert het oude concept en voegt een vervanging toe, waardoor het concept een nieuwe UID-identiteit krijgt. Gebruik zowel de uid als uidvalidity uit het antwoord voor alles wat volgt; het paar dat je doorgaf identificeert de vervanging niet meer.
• Een kopie van elk bericht komt terecht op een plek die je niet hebt opgegeven: de mailbox heeft een standaard-CC of standaard-BCC onder Instellingen → Profiel. Deze geldt voor wat de mailbox verzendt, ook via de API. Wis deze daar of geef apply_default_recipients: false door om de instelling voor één bericht uit te schakelen.
• Agenda-item niet gevonden: items zijn beperkt tot de specifieke mailbox. Controleer of het berichttoken voor de juiste mailbox is uitgegeven.