Holarch
Capítulos do curso

Treinamento · Trilha 5. Equipes e administração · Capítulo 5.4 de 6

5.4 Tokens de API e conexão do Claude 2:39

Usa recursos dos planos Individual e Team:

Tokens de acesso pessoal, conexão do Claude com OAuth e revisão do que ele propõe.

Mostra o Holarch 1.7.

O que você vai aprender

  • Criar um token de acesso pessoal com acesso, projetos e validade limitados
  • Conectar o Claude ao Holarch com login na tela de consentimento
  • Revisar uma proposta de um cliente de IA e aplicar apenas as alterações que você quer
  • Revogar um token e desconectar um aplicativo

Deixe scripts e ferramentas de IA trabalharem com seus projetos com segurança: crie um token de acesso pessoal com um escopo, projetos e uma validade; conecte o Claude com OAuth na tela de consentimento; gerencie os Aplicativos conectados; revise e aplique uma proposta de um cliente de IA; e a opção de API da organização.

Arquivos de projeto

  • Projeto inicial (.holarch.json; Gerenciar projetos → Arquivos de projeto ▾ → Importar projeto (.json)…)

O vídeo é reproduzido a partir de holarch.app; veja a Política de Privacidade.

Prática

Faça isto você mesmo no Holarch, no projeto de demonstração CubeSat EO-1.

  1. Abra Ajustes da conta → Tokens de API. Em Novo token, dê o nome EO-1 report, escolha Somente leitura, 30 dias e Projetos selecionados com o EO-1 marcado e clique em Criar token; copie o token.
  2. Execute o exemplo de curl de Token criado para listar seus projetos e confira que só o EO-1 é retornado.
  3. Clique em Conectar um aplicativo de IA…, escolha Claude e siga os passos. Em Conectar o Claude ao Holarch, escolha Ler e propor alterações, Projetos escolhidos com o EO-1 e um término em 30 dias, depois clique em Permitir.
  4. No Claude, peça: Propose a test case in EO-1 that verifies requirement 2.4 Target Slew.
  5. Abra o EO-1, escolha ✦ IA ▾ → Revisar “…”…, desmarque o que você não quiser e clique em Aplicar selecionados.
  6. De volta a Tokens de API, clique em Revogar em EO-1 report e, em Aplicativos conectados, clique em Desconectar se você não precisar do Claude conectado.

Você terminou quando o EO-1 tiver o novo caso de teste da proposta e o token tiver saído da sua lista.

Teste-se

  1. Quando usar um token, e quando um aplicativo conectado?
  2. Você é revisor em um projeto e usa um token de leitura e escrita. Um script pode alterar esse projeto?
  3. O Claude propõe cinco alterações. O que mudou no projeto?
  4. Como cortar todos os tokens e aplicativos de uma vez?
Mostrar as respostas
  1. Quando usar um token, e quando um aplicativo conectado?

    Um token é para scripts e clientes que enviam um cabeçalho fixo; ele é mostrado uma única vez e você o guarda. Um aplicativo conectado faz login na tela de consentimento do Holarch sem token colado, expira depois de no máximo um ano e aparece em Aplicativos conectados.

  2. Você é revisor em um projeto e usa um token de leitura e escrita. Um script pode alterar esse projeto?

    Não. Um token age como você, dentro do seu papel em cada projeto, então um revisor ou leitor apenas lê.

  3. O Claude propõe cinco alterações. O que mudou no projeto?

    Nada ainda. As alterações aguardam como proposta; você as revisa, desmarca o que não quer, e Aplicar selecionados transforma o resto em um único passo de desfazer. Exclusões e alterações em itens aprovados ou em linha de base começam desmarcadas.

  4. Como cortar todos os tokens e aplicativos de uma vez?

    Sair em todos os lugares, ou uma redefinição de senha, desconecta todos os aplicativos conectados e revoga todos os tokens. Um administrador da organização também pode desligar o acesso por API e MCP para os projetos da organização.

Saiba mais

Transcrição

Mostrar a transcrição (narração e o que aparece na tela)

Introduction

Chapter four: API tokens and connecting Claude. Holarch has an API for scripts and reports, and an MCP endpoint that lets AI tools such as Claude work with your model.

Personal access tokens

Whatever connects, the same rules apply.

On screen: Rules card.

API tokens come with the Individual and Team plans. For a script, create a personal access token: in Account Settings, open AI and API, give the token a name, choose Read only, an expiry of ninety days, and create it.

On screen: API tokens → name → Read only → 90 days → Create Token.

The token is shown once. Copy it now, and store it where your script can read it. Holarch keeps only a fingerprint of it, and lists the token with when it was last used.

On screen: The new token; the list.

Connect Claude

To connect Claude, add Holarch as a connector in Claude's settings with the address app dot holarch dot app slash mcp, and click Connect. For this recording, a test client stands in for Claude, using the same steps.

On screen: Card: in Claude; then the consent screen.

Holarch opens its consent screen. It names the app and where it returns you, and you choose what it may do: read only, or read and propose changes; all your projects or chosen ones; and when it ends.

On screen: Consent screen.

Keep read and propose changes, and click Allow. Claude is now connected, and you get an email about it.

On screen: Allow.

Connected apps

Connected apps, in the same section, lists every app with its access, its projects and when it was last used. Disconnect cuts it off at once.

On screen: Account Settings → Connected apps.

Review a proposal

When Claude suggests changes to your model, nothing changes yet. They arrive as a proposal. Open the project: the AI menu shows the proposal waiting for review.

On screen: A proposal arrives; ✦ AI ▾.

Review it. You see each change, can edit it, and untick what you do not want. Apply Selected makes it one step you can undo.

On screen: Review → Apply Selected.

For the organization

An org admin can turn off API and AI-tool access for all of the organization's projects in Organization Settings. Tokens and connected apps then cannot reach them.

On screen: Organization Settings → API access.

Recap

Let's recap. Tokens are for scripts: scoped, limited to projects, and shown once. Claude connects with OAuth on a consent screen, appears under Connected apps, and its changes arrive as proposals you review.

Next, you set up AI for the organization.