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.

Agente de IA

Execute o seu rececionista AI a partir do Codex

Ligue o servidor MCP do Mercateer ao OpenAI Codex e gere o seu balcão diretamente da linha de comandos. O Codex lê chamadas e contactos, faz orçamentos com base na sua tabela de preços e marca serviços a partir de instruções em linguagem natural.

Instale em minutos Todas as integrações

O que é o Codex?

O OpenAI Codex é um agente de programação que funciona na sua linha de comandos e IDE, executando tarefas multi-etapa a partir de instruções em linguagem natural. Com o servidor MCP do Mercateer ligado, o Codex também pode realizar tarefas de balcão — obtendo chamadas e contactos, criando orçamentos com base na sua tabela de preços e marcando serviços sem sair da linha de comandos.

O que pode fazer com o Codex

Consulte chamadas, contactos e conversas

Verifique a agenda e os trabalhos orçamentados

Pesquise na sua lista de preços e crie orçamentos

Marque e reagende compromissos

IntegrationPages.Read and reply to inbox conversations

Subscreva eventos de chamadas, contactos e marcações

Instale em minutos

Abra a sua configuração do Codex

Edite ~/.codex/config.toml. Se o ficheiro ainda não existir, crie-o com o conteúdo abaixo.

Adicione o servidor MCP do Mercateer

Cole o excerto abaixo em ~/.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_

Utilize o Mercateer nas suas sessões

Uma vez autorizado, o Codex pode chamar as ferramentas do Mercateer juntamente com as suas outras capacidades, pedindo sempre a sua aprovação antes de efetuar qualquer ação que envolva custos ou alterações nas definições ativas.

Exemplos de instruções

Você

Obtenha as chamadas não atendidas de ontem e resuma o que cada chamador pretendia.

Você

Faça um orçamento para a instalação de um esquentador de água de 50 galões com base na minha lista de preços.

Você

Marque o trabalho da Cedar Lane para quinta-feira às 9h e confirme se o horário está livre.

Você

Encontre o contacto para (555) 123-4567 e mostre a última conversa.

Você

Quais foram as chamadas esta semana que solicitaram um serviço que ainda não oferecemos?

Perguntas frequentes

Funciona com toda a sua stack

O Mercateer utiliza os mesmos protocolos das ferramentas que já utiliza.

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

Ver todas as integrações

Coloque o Mercateer a funcionar com o Codex

Comece gratuitamente e ligue o seu atendimento em minutos.

Comece gratuitamente

Não é necessário cartão de crédito

Execute o seu rececionista AI a partir do Codex

O que é o Codex?

O que pode fazer com o Codex

Instale em minutos

Abra a sua configuração do Codex

Adicione o servidor MCP do Mercateer

IntegrationPages.Authorize over OAuth

Utilize o Mercateer nas suas sessões

Exemplos de instruções

Perguntas frequentes

Como funciona o Mercateer com o Codex?

Do que precisa o Codex para autenticar?

Quais as versões da CLI do Codex suportadas?

Que plano do Mercateer preciso?

Existem limites de taxa?

Posso dar acesso apenas de leitura a um agente?

O que acontece aos meus dados?

Funciona com toda a sua stack

Coloque o Mercateer a funcionar com o Codex