APIMart MCP

npx add-mcp 'https://mcp.apimart.ai/mcp'

agent — Simulação de demonstração de tarefas do APIMart

“Me ajude a encontrar um modelo adequado para a imagem principal do produto, gerar um anúncio de perfume e me informar o resultado da tarefa.”

1. 01 Entender a necessidade Identificar a tarefa de geração de imagem
2. 02 Selecionar o modelo Comparar capacidades e parâmetros
3. 03 Enviar a tarefa Chamar a API do APIMart
4. 04 Retornar o resultado Obter status e arquivos

Exemplo de conclusão de tarefa

O Agent prepara os parâmetros conforme a documentação do modelo, envia a tarefa e obtém o resultado. Aqui é apenas uma demonstração do fluxo; nenhuma solicitação é enviada e nenhum crédito é consumido. Ver mais exemplos de conversa

Use list_models do APIMart MCP para listar 5 modelos disponíveis, sem gerar conteúdo.

→ APIMart / list_models
  {"limit": 5}

模型展示名称（示例，非 API 模型 ID）：
01  GPT Image 2.5
02  Nano Banana Pro
03  Seedream 5.0 Pro
04  Z-Image Turbo
05  Midjourney

✓ 示例数据。实际数量与模型 ID 以当前 Key 的返回结果为准。

Três formas de integração, conforme sua necessidade

Escolha entre documentação, ferramenta remota ou skill local, de acordo com seu hábito de uso. As operações suportadas dependem da interface, ferramenta e cliente correspondentes.

Siga os passos para concluir a integração

Escolha uma forma e siga os passos para concluir a configuração. Os comandos podem ser copiados diretamente e os prompts de teste já estão prontos.

APIMart Agent Tools

macOS · zsh · Codex desktop · ambiente de produção

Configuração segura da API Key

Disponível em ambiente de produção

Primeiro, crie uma API Key válida no APIMart e, em seguida, execute o comando abaixo no terminal zsh do macOS, inserindo a Key de forma oculta conforme solicitado.

Obter API Key

Comando no terminal

read -s "APIMART_API_KEY?APIMart API Key: "
echo
launchctl setenv APIMART_API_KEY "$APIMART_API_KEY"
unset APIMART_API_KEY

A Key real deve ser colada apenas quando o terminal solicitar a entrada. Não a escreva em comandos, conversas ou capturas de tela; Keys vazadas devem ser revogadas e recriadas.

Mais detalhes e escopo de aplicação

Esta configuração se aplica a aplicativos de desktop reiniciados na sessão de login atual. Após a configuração, saia completamente e reabra o Codex desktop. Se estiver usando a versão de terminal, execute export APIMART_API_KEY após inserir a Key de forma oculta e inicie o Codex a partir do mesmo terminal; não execute o unset indicado aqui. Abaixo está apenas uma ilustração do formato da chave; não é necessário executar ou substituir.

Ilustração do formato da chave · não é necessário executar sk-••••••••••••••••

Como escolher depende do seu hábito de uso

Consulte rapidamente a documentação com AI Docs, use MCP para chamadas de ferramentas no dia a dia e Skill para scripts locais e fluxos fixos.

Forma de integração	Mais adequado para	Instalação e configuração	Local de execução	Principais vantagens	Pontos de atenção	Início rápido
AI Docs llms.txt	Consultas pontuais, geração de código de chamada	Sem instalação, basta copiar o prompt	O Agent lê a documentação e executa o código	Leve e flexível para chamar a interface	Requer capacidade de leitura web; executar código ainda exige credenciais	Ver etapas de integração
MCP Recomendado	Interações frequentes, criação diária	Configurar serviço remoto e Key	MCP remoto do APIMart	Ferramentas estruturadas, sem pacote MCP local	Depende de rede e suporte do cliente; limitado às ferramentas fornecidas	Ver etapas de integração
Agent Skill (pacote de skill local)	Fluxos fixos, padronização de equipe	Instalar diretório completo via GitHub	Script local chama a API do APIMart	Fluxo reutilizável, independente do MCP	Requer Node.js; pode ser necessário reinstalar em atualizações	Ver etapas de integração

O que o Agent pode fazer por você

Focado em descoberta de modelos, compreensão de documentação e tarefas comuns de imagem e vídeo. Antes de usar, confirme se o modelo, a ferramenta ou o cliente local selecionado suporta a operação correspondente.

Descoberta de modelos

Encontre modelos disponíveis com base no objetivo da tarefa e confirme as capacidades e versões adequadas à necessidade atual.

Parâmetros e documentação

Leia parâmetros de entrada, instruções de uso e limitações para entender como o modelo é chamado.

Geração de imagens

Realize seleção de modelo, preparação de parâmetros, envio de tarefa, consulta de status e obtenção de resultado.

Geração de vídeos

Chame modelos de vídeo e acompanhe continuamente o progresso da tarefa, o status de execução e o resultado final.

A API Key não aparece no comando de instalação

Transmita as credenciais por variáveis de ambiente para reduzir o risco de a Key ser salva acidentalmente no histórico do terminal, em capturas de tela ou em conversas.

• Leia a documentação antes de configurar as credenciais A AI Docs ajuda o Agent a entender a interface, sem iniciar chamadas de modelo automaticamente.
• Leia por variável de ambiente MCP e Skill leem a Key de variáveis de ambiente; não escreva a Key em prompts ou comandos de instalação.
• Consulte o modelo primeiro para validar a conexão A geração real é cobrada conforme as regras da conta APIMart. Após a integração, use uma consulta de modelo para validar a configuração.

Perguntas frequentes

Escolha uma forma e comece a usar

MCP e Skill são independentes; a AI Docs não requer instalação e o prompt pode ser copiado diretamente.