Conectar Aplicativos (ComposioHQ/connect-apps)

Conectar Aplicativos

Conecte o Claude a mais de 1000 aplicativos usando a CLI do Composio. Envie e-mails, crie issues, poste mensagens – não apenas gere texto sobre isso.

Início Rápido

Passo 1: Instale a CLI do Composio

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

Passo 2: Faça Login

composio login
composio whoami

Abre um navegador para autenticação e depois pede que você escolha uma org e um projeto padrão. Use -y para pular etapas em scripts.

Passo 3: Vincule os Aplicativos Necessários

composio link gmail
composio link slack
composio link github

Cada comando executa o OAuth uma vez; a conexão persiste.

Passo 4: Teste

composio execute GMAIL_SEND_EMAIL -d '{
  "recipient_email": "[email protected]",
  "subject": "Teste Composio",
  "body": "Olá da CLI"
}'

Se o e-mail chegar, você está conectado.

O que Você Pode Fazer

Peça ao Claude...	Claude executa
"Enviar e-mail para [email protected] sobre o lançamento"	composio execute GMAIL_SEND_EMAIL -d '{...}'
"Criar issue no GitHub: corrigir bug de login"	composio execute GITHUB_CREATE_ISSUE -d '{...}'
"Postar no Slack #geral: implantação concluída"	composio execute SLACK_SEND_MESSAGE -d '{...}'
"Adicionar notas de reunião ao Notion"	composio execute NOTION_CREATE_PAGE -d '{...}'

Fluxo de Trabalho Principal

1. Sabe o slug da ferramenta? → composio execute <SLUG> -d '{...}'
2. Não sabe? → composio search "o que você quer"
3. Precisa de entradas? → composio execute <SLUG> --get-schema ou --dry-run
4. Não conectado? → composio link <toolkit> e tente novamente
5. Multi-etapas? → composio run para fluxos JS/TS, composio proxy para API bruta

Aplicativos Suportados

E-mail: Gmail, Outlook, SendGrid Chat: Slack, Discord, Teams, Telegram Dev: GitHub, GitLab, Jira, Linear Docs: Notion, Google Docs, Confluence Dados: Sheets, Airtable, PostgreSQL E mais de 1000 outros...

Comandos Úteis

# Descobrir ferramentas
composio search "criar uma issue no github"
composio tools list gmail
composio tools info GITHUB_CREATE_ISSUE

# Inspecionar / simular antes de executar
composio execute GITHUB_CREATE_ISSUE --get-schema
composio execute GITHUB_CREATE_ISSUE --dry-run -d '{"owner":"acme","repo":"app","title":"Bug"}'

# Executar em paralelo
composio execute --parallel \
  GMAIL_FETCH_EMAILS -d '{"max_results": 2}' \
  GITHUB_GET_THE_AUTHENTICATED_USER -d '{}'

# Fluxo multi-etapas
composio run '
  const issue = await execute("GITHUB_CREATE_ISSUE", {
    owner: "acme", repo: "app", title: "Bug", body: "..."
  });
  console.log(issue);
'

# Chamada de API bruta quando não existe ferramenta dedicada
composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile --toolkit gmail

Configuração

Variáveis de ambiente:

• COMPOSIO_API_KEY – credencial de autenticação para uso não interativo
• COMPOSIO_BASE_URL – endpoint de API personalizado
• COMPOSIO_SESSION_DIR – sobrescrever armazenamento de artefatos
• COMPOSIO_DISABLE_TELEMETRY=true – desativar telemetria

Flags globais: --log-level <all|trace|debug|info|warning|error|fatal|none>, --help.

Solução de Problemas

• Não está logado → execute composio login
• Conexão necessária para <toolkit> → execute composio link <toolkit>
• Slug desconhecido → composio search "<objetivo>" ou composio tools list <toolkit>
• Entradas incorretas → composio execute <SLUG> --get-schema depois --dry-run
• Ação falhou → verifique permissões no aplicativo de destino

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

---