ComposioHQ/conectar

O que conectar faz?

Conecte o Codex a qualquer aplicativo usando a CLI do Composio. Pare de gerar texto sobre o que você poderia fazer - faça de verdade a partir do shell.

Quando Usar Esta Skill

Use esta skill quando precisar que o Codex:

• Envie aquele e-mail em vez de rascunhá-lo
• Crie aquela issue em vez de descrevê-la
• Publique aquela mensagem em vez de sugeri-la
• Atualize aquele banco de dados em vez de explicar como

O que Muda

Sem Conectar	Com Conectar
"Aqui está um rascunho de e-mail..."	Envia o e-mail
"Você deveria criar uma issue..."	Cria a issue
"Poste isso no Slack..."	Posta a mensagem
"Adicione isso ao Notion..."	Adiciona o conteúdo

Aplicativos Suportados

Mais de 1000 integrações incluindo:

• E-mail: Gmail, Outlook, SendGrid
• Chat: Slack, Discord, Teams, Telegram
• Dev: GitHub, GitLab, Jira, Linear
• Doc: Notion, Google Docs, Confluence
• Dados: Sheets, Airtable, PostgreSQL
• CRM: HubSpot, Salesforce, Pipedrive
• Armazenamento: Drive, Dropbox, S3
• Redes Sociais: Twitter, LinkedIn, Reddit

Configuração

1. Instale a CLI do Composio

curl -fsSL https://composio.dev/install | bash

2. Faça Login

composio login
composio whoami

Isso abre um navegador para autenticação e permite escolher sua organização e projeto padrão. Use -y para pular prompts em fluxos automatizados.

3. Vincule os Toolkits que Você Precisa

composio link github
composio link gmail
composio link slack

Cada comando guia pelo OAuth uma vez, e a conexão persiste.

Pronto. O Codex agora pode controlar qualquer aplicativo conectado a partir do shell.

Fluxo de Trabalho Principal

1. Sabe o slug da ferramenta? → composio execute
2. Não sabe o slug? → composio search
3. Precisa de esclarecimentos sobre entradas? → composio execute --get-schema ou --dry-run
4. Toolkit não conectado? → composio link <toolkit> e tente novamente
5. Múltiplas etapas necessárias? → composio run para workflows, composio proxy para chamadas de API raw

Exemplos

Descubra uma Ferramenta

composio search "create a github issue"
composio search "send an email" --toolkits gmail

Inspecione Entradas Antes de Chamar

composio tools info GITHUB_CREATE_ISSUE
composio execute GITHUB_CREATE_ISSUE --get-schema
composio execute GITHUB_CREATE_ISSUE --dry-run -d '{"owner":"acme","repo":"app","title":"Bug"}'

Envie um E-mail

composio execute GMAIL_SEND_EMAIL -d '{
  "recipient_email": "[email protected]",
  "subject": "Enviado!",
  "body": "A v2.0 está no ar, me avise se houver problemas"
}'

Crie uma Issue no GitHub

composio execute GITHUB_CREATE_ISSUE -d '{
  "owner": "my-org",
  "repo": "repo",
  "title": "Bug de timeout no mobile",
  "labels": ["bug"]
}'

Poste no Slack

composio execute SLACK_SEND_MESSAGE -d '{
  "channel": "engineering",
  "text": "Deploy concluído - v2.4.0 no ar"
}'

Execute Chamadas em Paralelo

composio execute --parallel \
  GMAIL_FETCH_EMAILS -d '{"max_results": 2}' \
  GITHUB_GET_THE_AUTHENTICATED_USER -d '{}'

Encadeie Ações com composio run

composio run '
  const issues = await search("github issues labeled bug this week");
  const summary = issues.map(i => `- ${i.title}`).join("\n");
  await execute("SLACK_SEND_MESSAGE", {
    channel: "bugs",
    text: `Bugs desta semana:\n${summary}`
  });
'

Carregue workflows reutilizáveis de um arquivo:

composio run --file ./workflow.ts -- --repo composiohq/composio

Acesso à API Raw (proxy)

Quando não existe uma ferramenta dedicada, acesse a API autenticada diretamente:

composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile \
  --toolkit gmail

composio proxy https://gmail.googleapis.com/gmail/v1/users/me/drafts \
  --toolkit gmail -X POST -H 'content-type: application/json' \
  -d '{"message":{"raw":"..."}}'

Como Funciona

1. Você pede ao Codex para fazer algo
2. Codex escolhe um slug via composio search ou conhecimento prévio
3. CLI verifica a conexão, solicita composio link se ausente
4. A ação é executada contra a API real e retorna JSON para stdout

Configuração

Flags globais:

• --log-level <all|trace|debug|info|warning|error|fatal|none>
• --help para documentação por comando

Variáveis de ambiente:

• COMPOSIO_API_KEY - credencial de autenticação (defina para uso não interativo)
• COMPOSIO_BASE_URL - endpoint de API personalizado
• COMPOSIO_SESSION_DIR - substituir armazenamento de artefatos
• COMPOSIO_DISABLE_TELEMETRY=true - optar por não enviar telemetria

SDK Type-Safe (Opcional)

Gere código cliente tipado quando quiser chamar ferramentas de um aplicativo em vez do shell:

composio generate ts    # Tipos TypeScript
composio generate py    # Tipos Python

Flags: -o <dir>, --toolkits <list>, --compact, --transpiled, --type-tools.

Solução de Problemas

• Not logged in → execute composio login
• Connection required for <toolkit> → execute composio link <toolkit>
• Slug desconhecido → composio search "<o que você quer>" ou composio tools list <toolkit>
• Entradas incorretas → composio execute <SLUG> --get-schema depois --dry-run
• Falha na ação → verifique permissões no aplicativo de destino

Referência completa: docs.composio.dev/docs/cli

---