🧩 Skill vs Connector vs MCP
Três conceitos, três funções complementares. Misturar é o erro #1 dos iniciantes.
🎯 Os três na prática
| Tipo | O que é | Exemplo |
|---|---|---|
| Skill | Instrução procedural ("como fazer") | "Rode trend scan no X via Grok" |
| Connector | Ponte OAuth pra serviço externo | Gmail, Notion, Canva |
| MCP server | Ponte programável pra qualquer API | stripe-mcp, postgres-mcp |
🧠 Regra mental
Skill é "como". Connector é "com o quê" (oficial). MCP é "com o quê" (custom). Skill chama Connector ou MCP — nunca o contrário.
✅ Conectores aprovados
A Anthropic mantém uma lista oficial de conectores prontos via OAuth de 1 clique. Sempre que existir um oficial, use-o em vez de MCP custom.
💡 Dica
Conector oficial é mais seguro e estável que MCP custom. Token gerenciado, revogação fácil, audit log. Comece sempre por ele.
➕ Custom connector (case Apify)
Apify não está na lista oficial. Mas é trivial adicionar como custom connector. Esse caso vale ouro porque destrava 20k+ scrapers (Instagram, TikTok, Google Maps, etc).
No Cowork: ➕ → Connectors → Manage
Abre o painel de conectores instalados.
Add custom connector
Você cola o texto de configuração (Apify publica esse texto na doc deles).
Connect → OAuth
Abre o browser, você faz login no Apify, autoriza. Não precisa API key manual.
Allow access
Cowork volta com Apify funcionando. Teste com prompt simples antes.
🔧 MCP servers: quando usar
MCP (Model Context Protocol) é o padrão aberto da Anthropic pra expor ferramentas a qualquer agente. Use quando: serviço não tem conector oficial, você precisa de controle fino, ou quer rodar local.
🌐 Onde encontrar MCPs
- • MCP Registry oficial: índice da Anthropic com servidores certificados
- • Comunidade no GitHub: repos públicos pra Postgres, Stripe, Supabase, Vercel, etc
- • Self-hosted: você escreve o MCP em Python/Node e roda local
Quando MCP > Connector
- •API obscura sem OAuth (ex: ERPs internos)
- •Você quer expor uma ferramenta CUSTOM (ex: seu sistema próprio)
- •Performance crítica (MCP local, sem rede)
- •Dados sensíveis que não podem sair da máquina
🛡️ Segurança e permissões
Princípio do menor privilégio. Cada conector pede escopos (read, write, admin). Conceda só o que precisa.
✓ Boas práticas
- ✓Read-only sempre que possível
- ✓Scope específico (ex: Gmail labels:read, não admin)
- ✓Conta dedicada do Cowork (Gmail secundário)
- ✓Revisar audit log mensalmente
✗ Evite
- ✗Conceder admin "pra não dar erro"
- ✗Usar mesmo Gmail pessoal + Cowork
- ✗API keys em prompt em texto puro
- ✗MCP de fonte desconhecida (revise código antes)
🩺 Debug: conector que não responde
90% dos erros são OAuth expirado ou escopo faltando. Esse checklist resolve a maioria em <3 min.
🔍 Checklist de diagnóstico
- Token expirou? Manage Connectors → reconnect.
- Escopo certo? Verifique se o connector pede write e você só deu read.
- Rate limit? Google/Notion têm cotas. Espere 60s e tente.
- Conector está caído? Status page da Anthropic ou do provedor.
- Prompt ambíguo? Teste com o mais simples possível: "Liste minhas labels do Gmail."
- MCP local rodando? Se for MCP, confirme que o processo está vivo (ps/htop).
⚠️ Atenção
Se o conector funcionar com prompt simples mas falhar com complexo, o problema não é conector — é o prompt. Volte pra Trilha 1 módulo 1.6.
📚 Resumo do Módulo
Próximo Módulo:
1.5 — ⏰ Tarefas agendadas e agent-to-agent