---
title: User Management
description: Controle quem pode acessar sua organização e o que cada um pode fazer
icon: Users
---

import Callout from "../../../../components/ui/Callout.astro";

## Como funciona o controle de acesso

O deco Studio ajuda você a gerenciar quem pode fazer o quê na sua org. Pense nisso como gerenciar o acesso a um Google Drive compartilhado ou a uma organização no Slack — você decide quem está no seu time e o que cada um pode fazer.

Existem duas formas principais de controlar o acesso:

- **Roles dos members do time** — O que as pessoas da sua org podem fazer (visualizar, editar, gerenciar configurações, etc.)
- **Permissions de API keys** — O que sistemas automatizados ou tools externas podem fazer quando se conectam à sua org

## Roles do time

Quando você cria uma org, automaticamente recebe três roles para atribuir aos members do time:

- **Owner**: Controle total sobre tudo, incluindo deletar a org ou remover members do time
- **Admin**: Pode gerenciar operações do dia a dia, como adicionar connections, criar agents e convidar usuários
- **Member**: Acesso básico para visualizar e usar connections existentes (ótimo para members do time que só precisam trabalhar com o que já está configurado)

### Criando roles personalizados

Precisa de algo mais específico? Você pode criar roles personalizados de acordo com as necessidades do seu time.

**Exemplo**: Crie um role "Developer" que pode gerenciar connections e agents, mas não pode deletar nada, ou um role "Viewer" que só pode ver o que está configurado sem fazer alterações.

Para criar um role personalizado:

1. Vá em **Settings → Roles**
2. Clique em **Create Role**
3. Dê um nome a ele (como "Developer" ou "Support Team")
4. Selecione quais ações esse role deve ter permissão para realizar

Depois atribua o role às pessoas a partir da página **Members**.

<Callout type="tip">
  **Dica**: Comece com a menor quantidade de acesso necessária e adicione mais permissions conforme for preciso. É mais fácil conceder mais acesso depois do que lidar com alterações ou exclusões acidentais.
</Callout>

## Permissions de API keys

As API keys permitem que tools externas ou sistemas automatizados acessem sua org sem exigir que alguém faça login. Quando você cria uma API key, você escolhe exatamente o que ela tem permissão para fazer.

**Exemplos de casos de uso**:
- Um sistema de monitoramento que só precisa ler o status das connections
- Um script de deploy que precisa criar novas connections
- Uma integração de terceiros que só deve acessar agents específicos

**Boa prática**: Dê a cada API key apenas as permissions de que ela realmente precisa. Se um script apenas lê dados, não dê a ele permissão para deletar coisas.

## Onde gerenciar o acesso

Você vai trabalhar com essas configurações em alguns lugares diferentes:

- **Página Members**: Convide colegas de time e atribua roles
- **Página Roles** (**Settings → Roles**): Crie e edite roles personalizados
- **API Keys**: Gerenciadas via tools de MCP management ou pela API (veja [API Keys](/pt-br/studio/api-keys))
- **Página Agents**: Controle quais tools e connections cada agent pode acessar (útil para limitar o que assistentes de IA ou automations podem fazer)

## Exemplos práticos

### Dar acesso de admin a um member do time

**Quando**: Você quer que alguém ajude a gerenciar connections e convidar novos members do time

1. Vá em **Members**
2. Encontre o nome da pessoa
3. Clique no role atual dela (provavelmente "Member")
4. Selecione **Admin**

### Criar uma API key para uma tool de monitoramento

**Quando**: Você tem um sistema que precisa verificar se suas connections estão funcionando

Use as tools de MCP management ou a API para criar uma key com permissions somente leitura para connections. Veja [API Keys](/pt-br/studio/api-keys) para detalhes sobre como criar keys com permissions escopadas.

### Configurar um role "Read-Only Analyst"

**Quando**: Você tem members do time que precisam ver as configurações, mas não devem alterar nada

1. Vá em **Settings → Roles**
2. Clique em **Create Role**
3. Nomeie como "Read-Only Analyst"
4. Selecione apenas permissions de visualização (sem criar, atualizar ou deletar)
5. A partir da página **Members**, atribua esse role aos members do time apropriados
