> ## Documentation Index > Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # MCP > Conecte seu agente compatível com MCP ao Flowglad Conecte um agente compatível com MCP ao Flowglad para trabalhar com o conhecimento de negócio e o contexto operacional da sua organização. O conector pode encontrar e editar Pages, ler arquivos e registros conectados, criar Tasks, gerenciar Skills reutilizáveis e criar ou executar Automations. As ferramentas disponíveis dependem da identidade conectada, das permissões concedidas e dos recursos do produto habilitados. ## Aplique um template Quando `templates.apply` estiver disponível em `tools/list`, informe um `templateId` publicado e um `spaceId` existente para criar todos os recursos do template. Aplicações, Automations e cópias comuns de arquivos pertencem a esse Space; Skills pertencem à organização. Os arquivos usam os nomes configurados na raiz do Space e nunca substituem arquivos existentes. Um conflito de nomes iguais faz esse componente falhar, enquanto componentes independentes podem continuar. A conclusão de um arquivo significa que os bytes e os metadados foram salvos de forma durável; ela não aguarda a indexação. Opcionalmente, informe `connections` como um array de objetos `{ connector, connectionId }`, com no máximo uma conexão por provedor. As conexões informadas devem estar acessíveis, ser compatíveis e já estar atribuídas ao Space quando necessário. Conexões omitidas deixam os recursos aguardando configuração. A resposta recomenda conexões elegíveis ou a criação de uma conexão quando não houver nenhuma disponível. A criação é executada em uma única task do Trigger.dev, em ordem de dependência, com os resultados de cada componente registrados nos metadados e na saída da task. Novas tentativas automáticas da task inteira estão desativadas; uma task que falhe ou seja interrompida pode deixar recursos parciais. A resposta confirma que a criação foi enfileirada e inclui os componentes planejados e as recomendações de conexão; ela não confirma que os recursos terminaram de ser criados. Use as ferramentas list/get dos recursos para encontrá-los e inspecioná-los. Os recursos criados com sucesso permanecem se outro componente falhar. Aplicar um template adia a verificação executável e não ativa nem executa seus recursos. Cada chamada de aplicação cria novas cópias, inclusive em novas tentativas. Use as ferramentas de recursos para inspecionar o que foi criado. ## Antes de conectar Você precisa de: * Uma conta do Flowglad com acesso à organização que deseja usar. * A URL MCP de produção da sua organização. * Um agente ou cliente que suporte um servidor MCP remoto via Streamable HTTP e OAuth. * As permissões de organização e de Space necessárias para o trabalho pretendido. * Qualquer Connection de origem ou arquivo já disponível no Space relevante. A seção de preços publicada na [página inicial do Flowglad](https://www.flowglad.com/) inclui MCP nos planos Free, Plus e Max. As permissões de organização e de Space, a concessão OAuth e o acesso às fontes conectadas continuam se aplicando. As conexões com sistemas de negócio externos precisam ser configuradas no Flowglad e expostas ao Space pretendido antes que o agente possa usá-las. Consulte [Conectores](/docs/pt-BR/connectors.md) e [Spaces](/docs/pt-BR/spaces.md). ## Encontre a URL da sua organização O conector de produção usa uma URL específica da organização: ```text theme={null} https://dashboard.flowglad.com/api/mcp/orgs/{orgId} ``` Substitua `{orgId}` pelo ID real da sua organização no Flowglad. Preserve o ID completo, incluindo o prefixo `org_`. Não digite as chaves nem um ID de organização inventado. No Flowglad, abra **Settings** → **MCP** → **Add MCP Connection** → **Claude** → **Website**. Copie a URL MCP da organização exibida ali. Use as instruções de **Website** para uma URL remota; a aba separada **Desktop app** contém instruções de configuração pela linha de comando. Se você não conseguir acessar essas configurações, fale com o administrador do Flowglad ou com o [suporte](mailto:support@flowglad.com). Use a URL da organização para este conector. Uma URL específica de conexão pode expor um conjunto de ferramentas mais restrito e não é intercambiável com a URL da organização descrita aqui. ## Conecte pelo Claude Desktop Assista ao [vídeo de configuração do Claude Desktop](https://youtu.be/6qqSnrqDJ2o) ou siga as etapas abaixo. [Como conectar o Flowglad ao Claude Desktop](https://www.youtube.com/embed/6qqSnrqDJ2o) Use o fluxo de conector personalizado do Claude Desktop para adicionar o Flowglad e autorizar o acesso à sua conta. **1. Abra o formulário de conector personalizado.** No Claude Desktop, navegue até **Customize** → **Connectors** → **+ Add** → **Add Custom Connector**. **2. Adicione o conector do Flowglad.** Digite **Flowglad** como nome do conector ou escolha outro nome. Cole a URL MCP completa da sua organização no campo de URL. Você pode copiá-la em [Settings > MCP](https://dashboard.flowglad.com/settings/mcp). Ela deve ter este formato: `https://dashboard.flowglad.com/api/mcp/orgs/org_...` Não altere nenhuma outra configuração do conector. Selecione **Add** para continuar. Em algumas versões, o Claude Desktop pode rotular esse botão como **Continue**. **3. Conceda ao Claude acesso ao Flowglad.** Prossiga pelo fluxo de conexão para autorizar o Claude a acessar sua conta do Flowglad. Quando solicitado, faça login, confirme a organização do Flowglad pretendida e revise o acesso solicitado antes de autorizá-lo. Quando o fluxo for concluído, volte ao Claude Desktop e confirme que a conexão com o Flowglad está disponível. Peça ao Claude para verificar a conexão com o Flowglad e listar os Spaces aos quais você tem acesso. O OAuth Dynamic Client Registration é o método de conexão pretendido. Não adicione senha, token de acesso, chave de API ou client secret à URL do servidor. Estas instruções descrevem como conectar o Flowglad diretamente como um conector personalizado; a disponibilidade no diretório é um assunto separado. ## Conecte outro cliente MCP Adicione a mesma URL da organização como um servidor MCP remoto via Streamable HTTP. Conclua o fluxo OAuth do cliente com sua conta do Flowglad e, em seguida, verifique a organização e as ferramentas disponíveis. O suporte varia entre clientes. Uma conexão bem-sucedida com o servidor não significa que o cliente importa as Skills do Flowglad automaticamente. A extensão de descoberta de Skills e a ferramenta `skills.list` são interfaces diferentes. Consulte [Skills](/docs/pt-BR/skills.md) para ver o comportamento suportado de descoberta e gerenciamento de pacotes. ## Tratamento de dados O uso do MCP do Flowglad é regido pela [Política de Privacidade do Flowglad](https://www.flowglad.com/privacy-policy). Administradores da organização podem ver todas as chamadas de ferramentas MCP feitas à organização em [Settings > Audit](https://dashboard.flowglad.com/settings/audit). ## Solução de problemas | Sintoma | Próximo passo | | - | - | | A conexão falha antes do login | Verifique a URL HTTPS completa e o ID da organização. Confirme que o cliente suporta MCP remoto com OAuth. | | O login é bem-sucedido, mas o trabalho não está disponível | Verifique a organização selecionada, a membership no Space, a concessão MCP e as Connections disponíveis no Space. | | Uma ferramenta de escrita está indisponível ou é negada | Confirme as permissões de organização e de Space necessárias. Reconecte se for necessário um escopo OAuth recém-concedido. | | Um provedor conectado não pode ser lido | Confirme que a autorização dele está ativa e que a Connection está exposta ao Space pretendido. | | Uma Page ou arquivo não é encontrado | Confirme o Space correto, seus acessos diretos e vinculados, e que a fonte continua disponível. | | Uma operação retorna um ID de job ou de execução | Verifique o status final do ciclo de vida ou da execução antes de relatar sucesso ou tentar novamente. | | Uma escrita excede o tempo limite | Verifique se ela foi concluída antes de tentar novamente. Algumas operações criam um novo registro ou enfileiram trabalho a cada chamada. | | O acesso expira ou é revogado | Reconecte via OAuth e verifique a organização e a concessão pretendidas. Se a reconexão continuar falhando, entre em contato com o suporte. | Para informações gerais de segurança, consulte [Segurança](/docs/pt-BR/security.md) e nosso [Trust Center](https://trust.flowglad.com). Se tiver qualquer problema para se conectar, [fale conosco](mailto:support@flowglad.com). Ao entrar em contato com o suporte, inclua o horário, o cliente, a ferramenta afetada, o código de erro seguro e o ID da requisição, se disponível. Nunca inclua senhas, bearer tokens, cookies, URLs assinadas de upload/download nem dados de clientes. ## Related topics - [Skills](/docs/pt-BR/skills.md) - [Boas-vindas](/docs/pt-BR/agents/introduction.md) - [Automations](/docs/pt-BR/automations.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.