Missive MCP instellen

Om Missive MCP in te stellen heb je de Missive-entitlement op je mcp-core-licentie nodig en één Missive API-token in .env. Daarmee leest Claude gesprekken, berichten, contacten, taken en analytics. Mail versturen en gesprekken wijzigen verschijnt pas als de seat in read-write-modus draait en er een afzenderadres is ingesteld.

Wat heb je nodig om Missive MCP in te stellen?

Je hebt een draaiende mcp-core-installatie nodig en de Missive-add-on op dezelfde licentie. Nieuw met mcp-core? Begin met de installatiehandleiding van mcp-core en ga daarna verder met Missive MCP instellen.

• Een actieve licentie met de entitlement tool:missive. De add-on is de Missive MCP-server.
• Een Missive API-token, aangemaakt in de instellingen van je Missive-account.
• Voor schrijfmodus: een geverifieerde e-mailalias in dat Missive-account om vanaf te versturen.
• Een seat in Mijn account → MCP Self-hosted met de Missive-tool aangevinkt.

Heb je de add-on gekocht nadat je mcp-core had geïnstalleerd? Geen herinstallatie en geen nieuwe download nodig. De add-on wordt aan je licentie toegevoegd, en je krijgt een e-mail met de env-variabelen die de tool nodig heeft.

Welke env-variabelen leest Missive MCP?

De tool leest één verplichte variabele en twee optionele. De .env in je download bevat al MISSIVE_API_TOKEN= en de optionele regels als commentaar.

Een typisch blok voor read-write-gebruik:

MISSIVE_API_TOKEN=your-missive-api-token
[email protected]

MISSIVE_FROM_ADDRESS ligt bewust vast. Claude kan een weergavenaam instellen, maar nooit een ander afzenderadres kiezen. Zo kan Claude niet versturen vanaf een willekeurige alias die hij toevallig raadt. Dezelfde waarden kunnen ook in Mijn account → MCP Self-hosted → Tools staan. Daar worden ze versleuteld opgeslagen, een draaiende mcp-core pikt ze op zonder nieuwe download, en ze gaan voor op .env.

Welke tools krijgt Claude met Missive MCP in read-only-modus?

In read-only-modus krijgt Claude 14 tools om je inbox te lezen en geen enkele die iets wijzigt. Dit is de standaard voor elke seat, tenzij je read-write kiest.

• Gesprekken: missive_list_conversations, missive_get_conversation
• Berichten: missive_list_messages, missive_get_message
• Per gesprek: missive_list_conversation_posts, missive_list_conversation_comments, missive_list_conversation_drafts
• Taken: missive_list_tasks
• Contacten: missive_list_contacts, missive_get_contact, missive_list_contact_books, missive_list_contact_groups
• Analytics: missive_create_analytics_report, missive_get_analytics_report

missive_list_conversations heeft minstens één filter nodig: een mailbox (inbox, all, assigned, closed, snoozed, flagged, trashed, junked of drafts), een team-inbox of een gedeeld label. Standaard geeft hij 25 gesprekken terug, maximaal 50, en hij geeft Claude een until-waarde om verder terug te bladeren. Een analytics-rapport opvragen is een leesactie: het maakt een rapport aan in Missive, maar wijzigt geen gesprekken.

Wat voegt read-write-modus toe aan Missive MCP?

Read-write-modus registreert zeven extra tools die iets in je inbox doen. Je kiest de modus per seat wanneer je die toevoegt in Mijn account → MCP Self-hosted → Seats; MISSIVE_MODE is alleen de fallback. Zie entitlements vs. toolmodi voor hoe licentie en modus samenwerken.

• missive_send_message: een nieuwe e-mail of een antwoord in een bestaand gesprek, altijd vanaf MISSIVE_FROM_ADDRESS
• missive_create_task: een losse taak (vereist een team of toegewezen personen) of een subtaak bij een gesprek
• missive_update_conversation en missive_merge_conversations
• missive_create_post: een post in een gesprek, met een notificatietitel
• missive_create_contact en missive_update_contact

Sommige dingen zitten niet in de tool, omdat de REST API van Missive er geen endpoint voor heeft: comments aanmaken, een taak na het aanmaken bijwerken of afronden, teams, gebruikers, gedeelde labels en standaardantwoorden.

Hoe herstart je mcp-core en test je Missive MCP?

Draai het updatescript vanuit de map die je hebt uitgepakt. Het pullt de image en herstart mcp-core met je huidige .env.

./mcp-update.sh

Heb je de add-on net gekocht, start dan een licentiecheck zodat de entitlement nu binnenkomt:

docker exec mcp-core npm run refresh-license

Vraag Claude om mcp_status te draaien. Die toont de licentiestatus, de actieve seat, de tools ervan en de modus per tool. Probeer daarna “toon de 10 nieuwste gesprekken in mijn inbox”. Welke client welk seat-token gebruikt, lees je in MCP-seats.

Welke foutmeldingen kom je tegen bij het instellen van Missive MCP?

Deze meldingen komen van de tool zelf, dus je kunt ze woord voor woord vergelijken.

• Geen Missive-tools in Claude: het containerlog meldt “MISSIVE_API_TOKEN is not set”. Voeg het token toe, draai ./mcp-update.sh en controleer de entitlement en de toollijst van de seat.
• “MISSIVE_FROM_ADDRESS is not configured — cannot send”: read-write staat aan, maar de afzender ontbreekt. Stel een geverifieerde alias van het account in en herstart.
• “Provide at least one of mailbox, team_inbox, or shared_label”: Claude vroeg gesprekken op zonder filter. Vraag om een specifieke mailbox.
• “Missive API rate limit hit”: Missive staat 5 gelijktijdige verzoeken toe, 300 per minuut en 900 per 15 minuten. Wacht de retry-tijd uit de melding af.
• “Missive API error 401”: het token klopt niet of is ingetrokken. Maak een nieuw token aan in Missive en vervang het.
• “Rate limit exceeded for this tool”: dit is de eigen limiet per seat van mcp-core. Wacht het aantal seconden dat erbij staat.

Zodra mcp_status de tool toont en een testvraag gesprekken teruggeeft, is Missive MCP ingesteld. De andere add-ons staan in de MCP-installatiehandleidingen.