agentleFS
gavasquesgavasques/titanos-agent-skills/skills/titanos-mcp-setup/SKILL.md

titanos-mcp-setup

Skill0 starsChanged 3 months agoMITView on GitHub

Instalação e diagnóstico do MCP Titanos (@titanos/mcp-agents) — API Key, OAuth Amazon, scopes, whoami, get_server_guide. Use antes de qualquer outra skill Titanos ou quando o agente não encontra tools, retorna SCOPE_MISSING ou INVALID_API_KEY.

  • Reads credentials

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use esta skill quando o usuário / Use this skill when the user:

    line 11
  2. Very specific:

    Use @1 para sempre resolver a versão estável mais recente da linha 1.x.

    line 95

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Titanos MCP — Guia de instalação e setup

Quando usar / When to Use This Skill

Use esta skill quando o usuário / Use this skill when the user:

  • Precisa instalar ou diagnosticar o MCP Titanos (API key, OAuth, scopes)
  • O agente não encontra tools ou retorna SCOPE_MISSING / INVALID_API_KEY
  • Vai usar qualquer outra skill Titanos pela primeira vez

Skill base para conectar Claude Desktop, Claude Code, Cursor, Codex ou Hermes ao MCP Titanos. Todas as outras skills desta pasta assumem que este setup está concluído.

O que é

PeçaDetalhe
Pacote@titanos/mcp-agents (npm, stdio MCP)
APIhttps://www.titanos.com.br/api/mcp/*
AuthAuthorization: Bearer tnk_live_... (API Key)
Conta AmazonOAuth no painel web (tokens no vault Titanos — nunca no .env do MCP)

Plano mínimo para API Keys: Grow+ (feature.mcp.api_keys).

Passo 1 — Conta Titanos

  1. Acesse https://www.titanos.com.br e faça login.
  2. Conta → Integrações
    • Conecte Seller Central (SP-API) se for operar listings/estoque/relatórios seller.
    • Conecte Amazon Ads se for operar campanhas/relatórios PPC.
    • Status deve ficar ativo antes de tools seller/ads retornarem dados.
  3. Conta → Integrar com IA
    • Crie uma key com nome descritivo (ex.: Hermes Produção).
    • Copie o token completo (tnk_live_…, ~64 caracteres). Só aparece uma vez.

Passo 2 — Scopes da API Key

Escolha um preset ou marque manualmente conforme as skills que o usuário vai instalar:

Preset (UI)Quando usar
RecomendadoUso geral (seller + ads + agentes + mineração)
Somente leituraAuditoria sem mutação
Seller completoListings, estoque, pedidos, relatórios SP
Amazon Ads completoCampanhas + relatórios + write SP/SB/SD
Experimentos MCPTestes A/B (skill futura)

Matriz rápida (diagnóstico)

ScopeTools principais
agents:listing_power:invokeinvoke_listing_power
agents:readget_result, polling de jobs
amazon:lookuplookup_amazon_product
mining:searchsearch_products, get_best_sellers, find_private_label_opportunities, find_categories
seller:connections:readlist_seller_connections, guias
seller:listings:readget_listings, audit_listings, validate_listing, …
seller:listings:writeupdate_listing, create_listing, preview_listing
seller:inventory:readget_inventory
seller:orders:read / writeget_orders, request_review
seller:reports:readrequest_sp_report, ask_selling_partner_report_analyst
seller:finances:readFinanças SP
ads:connections:readlist_ads_connections, list_ads_profiles
ads:campaigns:readget_campaigns, recomendações, PPC memory
ads:reports:readget_ads_performance, ask_ads_report_analyst
ads:campaigns:writecreate/update/delete_resources

Keys antigas não ganham scopes novos automaticamente — revogue e recrie após upgrade de plano ou novas features.

Passo 3 — Configurar o cliente MCP

Claude Desktop / Claude Code

Arquivo de config MCP do cliente (caminho varia por OS):

{
  "mcpServers": {
    "titanos": {
      "command": "npx",
      "args": ["-y", "@titanos/mcp-agents@1"],
      "env": {
        "TITANOS_API_KEY": "tnk_live_COLE_A_KEY_COMPLETA_AQUI",
        "TITANOS_API_URL": "https://www.titanos.com.br"
      }
    }
  }
}
  • Use @1 para sempre resolver a versão estável mais recente da linha 1.x.
  • Nunca commite a key no git.
  • Key truncada → erro INVALID_API_KEY.

Hermes / OpenClaw

Informe o caminho da pasta de skills ou cole o conteúdo de SKILL.md. Para MCP, use o mesmo bloco JSON acima no config de servidores do Hermes.

Cursor

Adicione o servidor MCP nas configurações do projeto com o mesmo JSON (npx + env).

Passo 4 — Validar conexão (sempre)

Ordem obrigatória na primeira sessão:

1. whoami
2. get_server_guide({ "topic": "full" })
3. (Seller) list_seller_connections
4. (Ads) list_amazon_ads_integrations → list_amazon_ads_integration_accounts

whoami — o que checar

  • scopes[] contém o que a tarefa precisa
  • Plano ativo (Grow+)
  • Conexões Amazon listadas (seller / ads)

Guias embutidos (0 créditos)

ToolConteúdo
get_server_guideMapa geral MCP (tools, scopes, mineração)
get_seller_central_guideFluxos Seller Central
get_optimization_guidePlaybook PPC

Erros comuns

SintomaCausaAção
SCOPE_MISSINGKey sem permissãoRecriar key com scope ou preset correto
INVALID_API_KEYKey cortada ou revogadaNova key em Conta → Integrar com IA
AMAZON_CONNECTION_NOT_FOUNDOAuth não conectadoConectar em Conta → Integrações
Tools não aparecem no clienteCliente sem reiniciar após configReiniciar Claude/Hermes
Seller/Ads vazioConexão inativa ou perfil erradoReautorizar OAuth

Créditos (visão geral)

TipoExemplosCréditos
0whoami, guias, reads seller/ads básicos, analyst (warehouse)0
Mineração levesearch_products sem detalhes~200
Mineração fullincluir_detalhes: true~500
Listing Powerinvoke_listing_powerVariável (texto + imagens + A+)

Resposta MCP inclui credits_used — reporte ao usuário após invokes pagos.

Skills relacionadas (instalar depois do setup)

PastaCard na página
amazon-mining-researchMineração Amazon
super-listing-powerSuper Listing Power
listing-create-publishPublicar listing
Amazon-AdsAmazon Ads
…Ver nota Maestri / índice completo

Checklist antes de declarar “MCP pronto”

  • API Key criada e colada inteira no env
  • OAuth Seller e/ou Ads ativo (conforme uso)
  • whoami retorna scopes esperados
  • get_server_guide responde
  • Pelo menos um teste na área que o usuário vai usar (ex.: search_products ou list_seller_connections)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.