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.

Voice Agent

Führen Sie Ihren KI-Rezeptionisten über Codex aus

Verbinden Sie den Mercateer-MCP-Server mit OpenAI Codex und steuern Sie Ihre Front Office direkt aus dem Terminal. Codex liest Anrufe und Kontakte, erstellt Kostenvoranschläge aus Ihrem Preisbuch und bucht Aufträge – basierend auf einer natürlichsprachlichen Anweisung.

In Minuten installiert Alle Integrationen

Was ist Codex?

OpenAI Codex ist ein Coding-Agent, der in Ihrem Terminal und Ihrer IDE läuft und mehrschrittige Aufgaben aus natürlichsprachlichen Anweisungen ausführt. Mit verbundenem Mercateer-MCP-Server kann Codex auch Front-Office-Arbeiten erledigen: Anrufe und Kontakte abrufen, Kostenvoranschläge aus Ihrem Preisbuch erstellen und Aufträge buchen – ohne die Kommandozeile zu verlassen.

Was Sie mit Codex tun können

Anrufe, Kontakte und Gespräche nachschlagen

Terminplan und Angebotene Aufträge prüfen

Im Preisbuch suchen und Angebote erstellen

Termine buchen und neu vereinbaren

IntegrationPages.Read and reply to inbox conversations

Auf Anruf-, Lead- und Buchungsereignisse abonnieren

In Minuten installiert

Öffnen Sie Ihre Codex-Konfiguration

Bearbeiten Sie ~/.codex/config.toml. Falls die Datei noch nicht existiert, erstellen Sie sie mit dem folgenden Inhalt.

Den Mercateer-MCP-Server hinzufügen

Fügen Sie den folgenden Code-Ausschnitt in ~/.codex/config.toml ein.

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_

Nutzen Sie Mercateer in Ihren Sitzungen

Sobald autorisiert, kann Codex Mercateer-Tools neben seinen anderen Funktionen aufrufen und hält zur Genehmigung an, sobald Geld ausgegeben oder eine Live-Einstellung geändert wird.

Beispiel-Prompts

Sie

Rufen Sie die verpassten Anrufe von gestern ab und fassen Sie zusammen, was jeder Anrufer wollte.

Sie

Erstelle ein Angebot für den Einbau eines 50-Gallonen-Warmwasserbereiters aus meinem Preisbuch.

Sie

Buche den Auftrag für Cedar Lane am Donnerstag um 9 Uhr und bestätige, dass der Termin frei ist.

Sie

Finde den Kontakt für (555) 123-4567 und zeige das letzte Gespräch an.

Sie

Welche Anrufe diese Woche fragten nach einem Service, den wir noch nicht anbieten?

Häufig gestellte Fragen

Funktioniert mit Ihrem gesamten Tech-Stack

Mercateer spricht dieselben Protokolle wie die Tools, die Sie bereits nutzen.

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

Alle Integrationen anzeigen

Setzen Sie Mercateer mit Codex ein

Kostenlos starten und Ihr Front Office in Minuten verbinden.

Kostenlos starten

Keine Kreditkarte erforderlich

Führen Sie Ihren KI-Rezeptionisten über Codex aus

Was ist Codex?

Was Sie mit Codex tun können

In Minuten installiert

Öffnen Sie Ihre Codex-Konfiguration

Den Mercateer-MCP-Server hinzufügen

IntegrationPages.Authorize over OAuth

Nutzen Sie Mercateer in Ihren Sitzungen

Beispiel-Prompts

Häufig gestellte Fragen

Wie funktioniert Mercateer mit Codex?

Was benötigt Codex zur Authentifizierung?

Welche Codex-CLI-Versionen werden unterstützt?

Welchen Mercateer-Tarif benötige ich?

Gibt es Ratenlimits?

Kann ich einem Agent schreibgeschützten Zugriff gewähren?

Was passiert mit meinen Daten?

Funktioniert mit Ihrem gesamten Tech-Stack

Setzen Sie Mercateer mit Codex ein