How does Mercateer work with Codex?

Mercateer runs a public MCP server. You add it to ~/.codex/config.toml, and Codex can then call Mercateer tools to read calls and contacts, quote from your price book, and book appointments, from the terminal.

What does Codex need to authenticate?

Sign-in uses your Mercateer account over OAuth. Run `codex mcp login mercateer`, Codex opens a browser tab, you approve access, and the token is stored for you, so there are no API keys to paste.

Which Codex CLI versions are supported?

Any version that supports streamable HTTP MCP transport. If your version only supports stdio MCP, we recommend upgrading or using one of the other agents instead.

Which Mercateer plan do I need?

API and MCP access is included on the Crew and Fleet plans. You can start building free to set up your agent, then upgrade to connect Codex.

Are there rate limits?

Yes. API requests are rate-limited per caller (about 60 requests per minute per API key or connected agent). If you exceed the limit you get an RFC 9457 problem response with a Retry-After header, so the agent can back off and retry.

Can I give an agent read-only access?

Read-only scoping works through API keys, which each carry an explicit scope list, so you can issue a read-only key for lookups and a separate read-write key for agents that book jobs or update contacts. Note that the OAuth sign-in these agents use grants the agent the same full account access you have in the dashboard, so to keep an agent read-only you would connect it with a scoped API key rather than OAuth. Either way, actions that spend money or change live settings still pause for your confirmation.

What happens to my data?

Your calls, contacts, and pricing stay in your Mercateer organization. Agents act through scoped OAuth tokens or API keys, every request is logged, and actions that spend money or change live settings require your confirmation. Nothing is used to train a shared model.

AI-agent

Laat je AI-receptioniste werken vanuit Codex

Verbind de Mercateer MCP-server met OpenAI Codex en beheer je frontoffice vanuit de terminal. Codex leest oproepen en contacten, haalt offertes op uit jouw prijslijst en boekt klussen op basis van een instructie in natuurlijke taal.

Installeer binnen enkele minuten Alle integraties

Wat is Codex?

OpenAI Codex is een code-agent die in je terminal en IDE draait en taken met meerdere stappen uitvoert op basis van instructies in natuurlijke taal. Met de Mercateer MCP-server verbonden, kan Codex ook frontoffice-werk doen: oproepen en contacten ophalen, offertes maken op basis van jouw prijslijst en klussen boeken — zonder dat je de opdrachtregel hoeft te verlaten.

Wat je kunt doen met Codex

Zoek gesprekken, contacten en conversaties op

Controleer de agenda en aangeboden klussen

Doorzoek je prijslijst en stel offertes samen

Plan en herplan afspraken

IntegrationPages.Read and reply to inbox conversations

Abonneer je op gebeurtenissen rond gesprekken, leads en boekingen

Installeer binnen enkele minuten

Open je Codex-configuratie

Bewerk ~/.codex/config.toml. Als het bestand nog niet bestaat, maak het dan aan met de onderstaande inhoud.

Voeg de Mercateer MCP-server toe

Plak het onderstaande fragment in ~/.codex/config.toml.

toml

[mcp_servers.mercateer]
url = "https://api.mercateer.com/mcp"

IntegrationPages.Authorize over OAuth

IntegrationPages.Run `codex mcp login mercateer` in your terminal_ Codex opens the OAuth flow in your browser, sign in with your Mercateer account and approve access_ There are no API keys to paste_

Gebruik Mercateer in je sessies

Zodra geautoriseerd, kan Codex Mercateer-tools aanroepen naast zijn andere mogelijkheden, maar vraagt eerst jouw goedkeuring voor alles wat geld kost of een live-instelling wijzigt.

Voorbeeldprompts

Jij

Haal gisteren gemiste gesprekken op en vat op wat elke beller wilde.

Jij

Maak een offerte voor een 50-gallon boilerinstallatie op basis van mijn prijslijst.

Jij

Plan de klus aan Cedar Lane in voor donderdag om 9:00 en bevestig dat de plek vrij is.

Jij

Zoek het contact voor (555) 123-4567 en toon het laatste gesprek.

Jij

Welke gesprekken deze week vroegen om een dienst die we nog niet aanbieden?

Veelgestelde vragen

Werkt met je volledige stack

Mercateer spreekt dezelfde protocollen als de tools die je al gebruikt.

Claude Desktop Claude Code Claude Cowork ChatGPT Cursor Zapier n8n Make.com Webhooks

Bekijk alle integraties

Zet Mercateer aan het werk met Codex

Begin gratis en koppel je frontoffice binnen enkele minuten.

Begin gratis

Geen creditcard vereist

Laat je AI-receptioniste werken vanuit Codex

Wat is Codex?

Wat je kunt doen met Codex

Installeer binnen enkele minuten

Open je Codex-configuratie

Voeg de Mercateer MCP-server toe

IntegrationPages.Authorize over OAuth

Gebruik Mercateer in je sessies

Voorbeeldprompts

Veelgestelde vragen

Hoe werkt Mercateer samen met Codex?

Wat heeft Codex nodig voor authenticatie?

Welke Codex CLI-versies worden ondersteund?

Welk Mercateer-abonnement heb ik nodig?

Zijn er limieten op het aantal aanvragen?

Kan ik een agent alleen-lezenrechten geven?

Wat gebeurt er met mijn gegevens?

Werkt met je volledige stack

Zet Mercateer aan het werk met Codex