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

Use seu recepcionista de IA pelo Codex

Conecte o servidor MCP do Mercateer ao OpenAI Codex e gerencie seu atendimento pelo terminal. O Codex lê chamadas e contatos, faz cotações com base na sua tabela de preços e agenda serviços a partir de instruções em linguagem natural.

Instale em minutos Todas as integrações

O que é Codex?

O OpenAI Codex é um agente de programação que roda no seu terminal e IDE, executando tarefas de várias etapas a partir de instruções em linguagem natural. Com o servidor MCP do Mercateer conectado, o Codex também pode realizar tarefas administrativas, buscando chamadas e contatos, cotando com base na sua tabela de preços e agendando serviços sem que você precise sair da linha de comando.

O que você pode fazer com Codex

Consultar chamadas, contatos e conversas

Verificar a agenda e os serviços cotados

Pesquisar sua tabela de preços e montar cotações

Agendar e remarcar serviços

Leia e responda às conversas da caixa de entrada

Inscrever-se em eventos de chamadas, leads e agendamentos

Instale em minutos

Configuração em uma etapa

Caminho mais rápido: cole isto no Codex e ele mesmo conecta a Mercateer.

prompt

Fetch https://mercateer.com/prompt.md

Abra sua configuração do Codex

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

Adicione o servidor MCP do Mercateer

Cole o trecho abaixo em ~/.codex/config.toml.

toml

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

Autorize por OAuth

Execute `codex mcp login mercateer` no seu terminal. O Codex abre o fluxo OAuth no navegador: entre com a sua conta Mercateer e aprove o acesso. Não há chaves de API para colar.

Use o Mercateer nas suas sessões

Após autorizado, o Codex pode chamar ferramentas do Mercateer junto com suas outras funcionalidades, pedindo sua aprovação antes de executar qualquer ação que envolva gastos ou alterações em configurações ativas.

Exemplos de instruções

Você

Busque as chamadas não atendidas de ontem e resuma o que cada cliente queria.

Você

Cote a instalação de um aquecedor de água de 50 galões com base na minha tabela de preços.

Você

Agende o serviço na Cedar Lane para quinta-feira às 9h e confirme se o horário está disponível.

Você

Encontre o contato do número (555) 123-4567 e mostre a última conversa dele.

Você

Quais chamadas esta semana pediram um serviço que ainda não oferecemos?

Perguntas frequentes

Funciona com toda a sua pilha de ferramentas

O Mercateer fala os mesmos protocolos das ferramentas que você já usa.

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

Ver todas as integrações

Coloque o Mercateer para trabalhar com Codex

Comece gratuitamente e conecte seu atendimento inicial em minutos.

Começar grátis

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

Use seu recepcionista de IA pelo Codex

O que é Codex?

O que você pode fazer com Codex

Instale em minutos

Configuração em uma etapa

Abra sua configuração do Codex

Adicione o servidor MCP do Mercateer

Autorize por OAuth

Use o Mercateer nas suas sessões

Exemplos de instruções

Perguntas frequentes

Como o Mercateer funciona com o Codex?

O que o Codex precisa para autenticar?

Quais versões da CLI do Codex são compatíveis?

Qual plano do Mercateer eu preciso?

Há limites de taxa?

Posso conceder acesso somente leitura a um agente?

O que acontece com meus dados?

Funciona com toda a sua pilha de ferramentas

Coloque o Mercateer para trabalhar com Codex