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

Gestisci il tuo AI receptionist da Codex

Connetti il server MCP di Mercateer a OpenAI Codex e gestisci la tua segreteria dal terminale. Codex legge chiamate e contatti, fa preventivi dal tuo listino prezzi e prenota interventi da un'istruzione in linguaggio naturale.

Installazione in pochi minuti Tutte le integrazioni

Cos’è Codex?

OpenAI Codex è un agente di programmazione che gira nel tuo terminale e IDE, eseguendo attività in più passaggi da istruzioni in linguaggio naturale. Con il server MCP di Mercateer collegato, Codex può anche gestire la segreteria, recuperando chiamate e contatti, facendo preventivi dal tuo listino prezzi e prenotando interventi senza che tu debba abbandonare la riga di comando.

Cosa puoi fare con Codex

Cerca chiamate, contatti e conversazioni

Controlla il calendario e gli interventi preventivati

Cerca nel tuo listino prezzi e crea preventivi

Prenota e riprogramma appuntamenti

IntegrationPages.Read and reply to inbox conversations

Iscriviti agli eventi di chiamate, contatti e prenotazioni

Installazione in pochi minuti

Apri la configurazione di Codex

Modifica ~/.codex/config.toml. Se il file non esiste ancora, crealo con il contenuto qui sotto.

Aggiungi il server MCP di Mercateer

Incolla il frammento qui sotto 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_

Usa Mercateer nelle tue sessioni

Una volta autorizzato, Codex può chiamare gli strumenti di Mercateer insieme alle sue altre funzionalità, chiedendo la tua approvazione per qualsiasi operazione che comporti spese o modifichi impostazioni attive.

Esempi di prompt

Recupera le chiamate perse di ieri e riassumi cosa voleva ogni chiamante.

Fai un preventivo per l’installazione di uno scaldabagno da 50 galloni dal mio listino prezzi.

Prenota l’intervento in Cedar Lane per giovedì alle 9:00 e conferma che lo slot sia libero.

Trova il contatto per (555) 123-4567 e mostra la sua ultima conversazione.

Quali chiamate questa settimana hanno chiesto un servizio che non offriamo ancora?

Domande frequenti

Funziona con tutto il tuo stack

Mercateer parla gli stessi protocolli degli strumenti che usi già.

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

Vedi tutte le integrazioni

Metti Mercateer al lavoro con Codex

Inizia gratis e collega il tuo front office in pochi minuti.

Inizia gratis

Nessuna carta di credito richiesta

Gestisci il tuo AI receptionist da Codex

Cos’è Codex?

Cosa puoi fare con Codex

Installazione in pochi minuti

Apri la configurazione di Codex

Aggiungi il server MCP di Mercateer

IntegrationPages.Authorize over OAuth

Usa Mercateer nelle tue sessioni

Esempi di prompt

Domande frequenti

Come funziona Mercateer con Codex?

Cosa serve a Codex per l'autenticazione?

Quali versioni della CLI di Codex sono supportate?

Quale piano Mercateer mi serve?

Ci sono limiti di frequenza?

Posso dare a un AI agent accesso in sola lettura?

Cosa succede ai miei dati?

Funziona con tutto il tuo stack

Metti Mercateer al lavoro con Codex