> ## 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

> Ligue o seu agente compatível com MCP ao Flowglad

Ligue 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 connector pode encontrar e editar Pages, ler ficheiros e registos ligados, criar Tasks, gerir Skills reutilizáveis e criar ou executar Automations. As ferramentas disponíveis dependem da identidade ligada, das permissões concedidas e das funcionalidades do produto ativadas.

## Aplicar um template

Quando `templates.apply` estiver disponível em `tools/list`, forneça um `templateId` publicado e um `spaceId` existente para criar todos os recursos do template. As Applications, as Automations e as cópias de ficheiros comuns pertencem a esse Space; as Skills pertencem à organização. Os ficheiros usam os nomes configurados na raiz do Space e nunca substituem ficheiros existentes. Um conflito de nomes iguais faz falhar esse componente, enquanto os componentes independentes podem continuar. A conclusão de um ficheiro significa que os bytes e os metadados foram guardados de forma duradoura; não aguarda pela indexação.

Opcionalmente, forneça `connections` como uma matriz de objetos `{ connector, connectionId }`, com no máximo uma Connection por fornecedor. As Connections fornecidas têm de estar acessíveis, ser compatíveis e, quando necessário, já estar atribuídas ao Space. As Connections omitidas deixam os recursos a aguardar configuração. A resposta recomenda Connections elegíveis ou, quando não houver nenhuma disponível, a criação de uma Connection.

A criação é executada numa única tarefa Trigger.dev, por ordem de dependências, com os resultados de cada componente registados nos metadados e no output da tarefa. As novas tentativas automáticas da tarefa completa estão desativadas; uma tarefa falhada ou interrompida pode deixar recursos parciais. A resposta confirma que a criação foi colocada em fila e inclui os componentes planeados e as recomendações de Connections; não confirma que a criação dos recursos terminou. Use as ferramentas list/get dos recursos para os encontrar e inspecionar. 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 os seus recursos. Cada chamada de aplicação cria novas cópias, incluindo as novas tentativas. Use as ferramentas dos recursos para inspecionar o que foi criado.

## Antes de ligar

Precisa de:

* Uma conta Flowglad com acesso à organização que pretende usar.
* O 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 ficheiro já disponível no Space relevante.

A secçã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, o grant OAuth e o acesso às fontes ligadas continuam a aplicar-se.

As ligações a sistemas de negócio externos têm de ser configuradas no Flowglad e expostas ao Space pretendido antes de o agente as poder usar. Consulte [Connectors](/docs/pt/connectors.md) e [Spaces](/docs/pt/spaces.md).

## Encontrar o URL da sua organização

O connector de produção usa um URL específico da organização:

```text theme={null}
https://dashboard.flowglad.com/api/mcp/orgs/{orgId}
```

Substitua `{orgId}` pelo ID real da sua organização Flowglad. Preserve o ID completo, incluindo o prefixo `org_`. Não introduza as chavetas nem um ID de organização inventado.

No Flowglad, abra **Settings** → **MCP** → **Add MCP Connection** → **Claude** → **Website**. Copie o URL MCP da organização aí apresentado. Use as instruções de **Website** para um URL remoto; o separador **Desktop app**, separado, contém instruções de configuração pela linha de comandos.

Se não conseguir aceder a estas definições, peça ajuda ao administrador do Flowglad ou ao [suporte](mailto:support@flowglad.com).

Use o URL da organização para este connector. Um URL específico de uma connection pode expor um conjunto de ferramentas mais restrito e não é intercambiável com o URL da organização aqui descrito.

## Ligar a partir do Claude Desktop

Veja o [vídeo de configuração do Claude Desktop](https://youtu.be/6qqSnrqDJ2o) ou siga os passos abaixo.

[Como ligar o Flowglad ao Claude Desktop](https://www.youtube.com/embed/6qqSnrqDJ2o)

Use o fluxo de connector personalizado do Claude Desktop para adicionar o Flowglad e autorizar o acesso à sua conta.

**1. Abra o formulário de connector personalizado.**

No Claude Desktop, navegue até **Customize** → **Connectors** → **+ Add** → **Add Custom Connector**.

**2. Adicione o connector Flowglad.**

Introduza **Flowglad** como nome do connector ou escolha outro nome.

Cole o URL MCP completo da sua organização no campo de URL. Pode copiá-lo em [Settings > MCP](https://dashboard.flowglad.com/settings/mcp). Deve ter este aspeto: `https://dashboard.flowglad.com/api/mcp/orgs/org_...`

Não altere nenhuma outra definição do connector. Selecione **Add** para continuar. Em algumas versões, o Claude Desktop pode chamar a este botão **Continue**.

**3. Conceda ao Claude acesso ao Flowglad.**

Continue o fluxo de ligação para autorizar o Claude a aceder à sua conta Flowglad. Quando lhe for pedido, inicie sessão, confirme a organização Flowglad pretendida e reveja o acesso solicitado antes de o autorizar.

Quando o fluxo terminar, regresse ao Claude Desktop e confirme que a ligação ao Flowglad está disponível. Peça ao Claude para verificar a ligação ao Flowglad e listar os Spaces a que tem acesso.

O OAuth Dynamic Client Registration é o método de ligação previsto. Não acrescente uma password, access token, API key ou client secret ao URL do servidor.

Estas instruções descrevem como ligar o Flowglad diretamente como connector personalizado; a disponibilidade no diretório é uma questão separada.

## Ligar outro cliente MCP

Adicione o mesmo URL da organização como servidor MCP remoto Streamable HTTP. Conclua o fluxo OAuth do cliente com a sua conta Flowglad e, em seguida, verifique a organização e as ferramentas disponíveis.

O suporte varia consoante o cliente. Uma ligação bem-sucedida ao servidor não significa que o cliente importe automaticamente as Skills do Flowglad. A extensão de descoberta de Skills e a ferramenta `skills.list` são interfaces diferentes. Consulte [Skills](/docs/pt/skills.md) para conhecer o comportamento suportado de descoberta e de gestão de pacotes.

## Tratamento de dados

A utilização do MCP do Flowglad rege-se pela [Política de Privacidade do Flowglad](https://www.flowglad.com/privacy-policy). Os administradores da organização podem ver todas as chamadas a ferramentas MCP feitas à sua organização em [Settings > Audit](https://dashboard.flowglad.com/settings/audit).

## Resolução de problemas

| Sintoma | Próximo passo |
| - | - |
| A ligação falha antes do início de sessão | Verifique o URL HTTPS completo e o ID da organização. Confirme que o cliente suporta MCP remoto com OAuth. |
| O início de sessão é bem-sucedido, mas o trabalho não está disponível | Verifique a organização selecionada, a pertença ao Space, o grant 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. Volte a ligar se for necessário um âmbito OAuth recém-concedido. |
| Não é possível ler um fornecedor ligado | Confirme que a respetiva autorização está ativa e que a Connection está exposta ao Space pretendido. |
| Não é possível encontrar uma Page ou um ficheiro | Confirme o Space correto, o respetivo acesso direto e por ligação, e que a fonte continua disponível. |
| Uma operação devolve um ID de job ou de execução | Verifique o estado final do ciclo de vida ou da execução antes de reportar sucesso ou de tentar novamente. |
| Uma escrita excede o tempo limite | Verifique se foi concluída antes de tentar novamente. Algumas operações criam um novo registo ou colocam trabalho em fila a cada chamada. |
| O acesso expira ou é revogado | Volte a ligar através de OAuth e verifique a organização e o grant pretendidos. Se a reconexão continuar a falhar, contacte o suporte. |

Para informações gerais de segurança, consulte [Security](/docs/pt/security.md) e o nosso [Trust Center](https://trust.flowglad.com). Se tiver algum problema a ligar, [contacte-nos](mailto:support@flowglad.com).

Ao contactar o suporte, inclua a hora, o cliente, a ferramenta afetada, o código de erro seguro e o ID do pedido, se disponível. Nunca inclua passwords, bearer tokens, cookies, URLs assinados de upload/download nem dados de clientes.


## Related topics

- [Skills](/docs/pt/skills.md)
- [Boas-vindas](/docs/pt/agents/introduction.md)
- [Automations](/docs/pt/automations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.