> ## Documentation Index
> Fetch the complete documentation index at: https://muveya.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar um cliente

> Conecte um cliente MCP compatível com OAuth usando o login e a autorização no Console.

Use `https://api.muveya.com/mcp` como URL do servidor Streamable HTTP em um cliente MCP que ofereça autorização OAuth. Você não precisa de uma chave de API para o MCP. As chaves de API continuam autenticando a API separada `/v1`.

## Conectar

1. Adicione a URL do servidor ao seu cliente MCP e escolha a opção de login com OAuth.
2. O cliente descobre o servidor de autorização do Muveya e abre o navegador. Se você não estiver conectado, o Muveya Console pede que faça login primeiro.
3. Escolha a clínica odontológica cujos dados deseja compartilhar. Confira o nome do aplicativo e as permissões solicitadas em **Autorizar uma conexão MCP**.
4. Selecione **Autorizar** para conceder o acesso exibido ou **Recusar** para cancelar. O navegador volta ao cliente MCP. Depois, o cliente envia o token de acesso automaticamente.

A conexão só pode usar as permissões concedidas ao aplicativo e que sua associação atual à clínica odontológica também permite. A remoção da associação ou a revogação do acesso do aplicativo impede as próximas chamadas. Cada conexão pertence a uma única clínica odontológica.

## Permissões disponíveis

| Escopo OAuth | Permite |
| - | - |
| `inventory:read` | Listar unidades e consultar o estoque disponível. |
| `catalog:read` | Pesquisar no catálogo. |
| `catalog.cost:read` | Incluir custos do catálogo e das linhas de pedidos, se sua associação também permitir. |
| `orders:read` | Ler pedidos por ID. |
| `analytics:read` | Ler consumo e indicadores gerenciais. |

Os escopos `clinics:read` e `fulfillment:read` também são aceitos, embora nenhuma ferramenta MCP atual precise deles. As três ferramentas pessoais que exigem `approvals.decide` ou `fulfillment.pick` ainda não estão disponíveis nesta conexão OAuth somente leitura. Consulte as [ferramentas MCP](/docs/pt/mcp/tools).

## Se a conexão falhar

| O que aparece | O que fazer |
| - | - |
| Tela de login | Entre na conta e escolha uma clínica odontológica para continuar. |
| Solicitação de autorização inválida | Inicie a conexão novamente pelo cliente MCP. |
| Permissão indisponível | Peça à administração da clínica que revise sua associação. A autorização não concede uma permissão que você não possui. |
| `401` de `/mcp` | Conecte novamente pelo OAuth. Uma chave de API ou um token de outro servidor não funciona. |
| A ferramenta retorna `common.forbidden` | Confira a permissão exigida pela ferramenta e reconecte com um escopo permitido. |

Para um cliente próprio, use o fluxo OAuth 2.1 de código de autorização com PKCE e os metadados do recurso protegido do Muveya. O cliente obtém e guarda o token de acesso. Não cole o token em um chat nem em uma configuração compartilhada.


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