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

# Conectar o MCP Astecha ao Claude

> Em dez passos, o Claude passa a consultar os dados da sua operação na plataforma Astecha, com o seu próprio login e as suas permissões.

Em todo o processo, você só vai digitar **três valores** e fazer **login na plataforma**. O resto são cliques. Tempo estimado: **5 minutos**.

## Antes de começar

<Columns cols={3}>
  <Card title="URL do servidor MCP" icon="link">
    Endereço do servidor que o Claude vai acessar. Usado no **passo 4**.

    **Onde pegar:** Plataforma Astecha → **User › Docs › MCPs › Conectar**
  </Card>

  <Card title="OAuth Client ID" icon="id-card">
    Identificador público da integração. Usado no **passo 5**.

    **Onde pegar:** Plataforma Astecha → **User › Docs › MCPs › Conectar**
  </Card>

  <Card title="OAuth Client Secret" icon="key">
    Chave secreta da integração. Usada no **passo 5**. Guarde-a com cuidado e não a compartilhe.

    **Onde pegar:** enviado pelo time Astecha
  </Card>
</Columns>

<Info>
  **Login na plataforma.** Depois do passo 8, o navegador pede o seu login na plataforma Astecha. Use o mesmo usuário e senha que você já usa no dia a dia.

  **Os passos também estão na plataforma.** Em **User › Docs › MCPs › Conectar** você encontra a URL, o Client ID e este mesmo passo a passo.
</Info>

## Passo a passo

<Steps>
  <Step title="Abra as configurações do Claude">
    No canto inferior esquerdo, clique no seu nome para abrir o menu e escolha **Settings**. Atalho: `⌘ ,` no Mac ou `Ctrl ,` no Windows.

    <Frame>
      <img src="https://mintcdn.com/astecha/9-qdOMMutmYvfodu/images/conectar-mcp-claude/passo-01.png?fit=max&auto=format&n=9-qdOMMutmYvfodu&q=85&s=4e98131abbcaf86328d12096a32c12f1" alt="Menu do perfil do Claude com a opção Settings destacada" width="619" height="349" data-path="images/conectar-mcp-claude/passo-01.png" />
    </Frame>
  </Step>

  <Step title="Vá até Connectors">
    Digite `con` na busca de configurações e clique em **Connectors**. Se preferir, o item também aparece no menu lateral, em **Customize**.

    <Frame>
      <img src="https://mintcdn.com/astecha/9-qdOMMutmYvfodu/images/conectar-mcp-claude/passo-02.png?fit=max&auto=format&n=9-qdOMMutmYvfodu&q=85&s=d86a58ebcdf3fea0fe90be18e83d180c" alt="Busca das configurações com o resultado Connectors destacado" width="1169" height="534" data-path="images/conectar-mcp-claude/passo-02.png" />
    </Frame>
  </Step>

  <Step title="Adicione um conector personalizado">
    No canto superior direito, clique em **Add** e depois em **Add custom connector**.

    <Frame>
      <img src="https://mintcdn.com/astecha/9-qdOMMutmYvfodu/images/conectar-mcp-claude/passo-03.png?fit=max&auto=format&n=9-qdOMMutmYvfodu&q=85&s=8a70c24451e31506d038ea6add4406a3" alt="Tela Connectors com o menu Add e a opção Add custom connector destacados" width="1200" height="434" data-path="images/conectar-mcp-claude/passo-03.png" />
    </Frame>
  </Step>

  <Step title="Informe o nome e a URL do servidor">
    No primeiro campo, dê um nome ao conector, por exemplo **Astecha**. No segundo, cole a **URL do servidor MCP** copiada da plataforma. Depois clique em **Continue**.

    <Tip>**Preencher:** URL do servidor MCP</Tip>

    <Frame>
      <img src="https://mintcdn.com/astecha/9-qdOMMutmYvfodu/images/conectar-mcp-claude/passo-04.png?fit=max&auto=format&n=9-qdOMMutmYvfodu&q=85&s=2d1e1804bf1a37ceea7976948c246d5c" alt="Janela Add custom connector com os campos de nome e MCP server URL destacados" width="1218" height="565" data-path="images/conectar-mcp-claude/passo-04.png" />
    </Frame>
  </Step>

  <Step title="Informe o Client ID e o Client Secret">
    O Claude detecta a autenticação sozinho. Deixe **Sign in now** e **Use your own OAuth client** marcados, como vêm por padrão. Nos campos em destaque, cole o **OAuth Client ID** (da plataforma) e o **OAuth Client Secret** (enviado pelo time Astecha).

    <Tip>**Preencher:** OAuth Client ID e OAuth Client Secret</Tip>

    <Frame>
      <img src="https://mintcdn.com/astecha/9-qdOMMutmYvfodu/images/conectar-mcp-claude/passo-05.png?fit=max&auto=format&n=9-qdOMMutmYvfodu&q=85&s=2eea74497a289cb8f73ae0389906cd51" alt="Opções de autenticação com os campos OAuth client ID e OAuth client secret destacados" width="964" height="1078" data-path="images/conectar-mcp-claude/passo-05.png" />
    </Frame>
  </Step>

  <Step title="Salve o conector">
    Confira os dois campos preenchidos. Não é preciso adicionar headers nem mexer em **Advanced**. Clique em **Add**.

    <Frame>
      <img src="https://mintcdn.com/astecha/9-qdOMMutmYvfodu/images/conectar-mcp-claude/passo-06.png?fit=max&auto=format&n=9-qdOMMutmYvfodu&q=85&s=b1a61672f1893ca4541228b200d2409e" alt="Campos de Client ID e Client Secret preenchidos e o botão Add" width="636" height="619" data-path="images/conectar-mcp-claude/passo-06.png" />
    </Frame>
  </Step>

  <Step title="Conecte">
    O conector Astecha aparece na sua lista, ainda desconectado. Clique em **Connect**. O navegador vai abrir.

    <Frame>
      <img src="https://mintcdn.com/astecha/9-qdOMMutmYvfodu/images/conectar-mcp-claude/passo-07.png?fit=max&auto=format&n=9-qdOMMutmYvfodu&q=85&s=b3bce6a1ca4f5a8b5001cc684fe1437b" alt="Conector Astecha ainda não conectado, com o botão Connect destacado" width="1175" height="903" data-path="images/conectar-mcp-claude/passo-07.png" />
    </Frame>
  </Step>

  <Step title="Confirme a conexão no navegador e faça login">
    Uma página do Claude pergunta se você quer concluir a conexão. Como foi você que iniciou o processo no passo 7, clique em **Continuar conectando**.

    <Frame>
      <img src="https://mintcdn.com/astecha/9-qdOMMutmYvfodu/images/conectar-mcp-claude/passo-08.png?fit=max&auto=format&n=9-qdOMMutmYvfodu&q=85&s=278cce8036b1d7669bea9f8b8e1e4271" alt="Página Concluir a conexão de um conector, com o botão Continuar conectando" width="925" height="531" data-path="images/conectar-mcp-claude/passo-08.png" />
    </Frame>

    <Note>
      **Faça login na plataforma Astecha.** Em seguida aparece a tela de login da plataforma. Entre com o seu usuário e senha de sempre. Este é o único login do processo.
    </Note>
  </Step>

  <Step title="Autorize o acesso">
    A plataforma mostra o que o Claude poderá fazer em seu nome, sempre com as permissões do seu usuário. Clique em **Allow**.

    <Frame>
      <img src="https://mintcdn.com/astecha/9-qdOMMutmYvfodu/images/conectar-mcp-claude/passo-09.png?fit=max&auto=format&n=9-qdOMMutmYvfodu&q=85&s=9c39c0fee8c4ed4e9df3649328ce3267" alt="Tela de autorização CLAUDE_MCP_OAUTH com o botão Allow" width="626" height="460" data-path="images/conectar-mcp-claude/passo-09.png" />
    </Frame>
  </Step>

  <Step title="Pronto: o conector está ativo">
    De volta ao Claude, o conector Astecha aparece conectado, com a lista de ferramentas. Por padrão, cada ferramenta pede a sua aprovação antes de rodar (**Needs approval**). Se quiser, mude para **Always allow** nas ferramentas que você usa com frequência.

    <Frame>
      <img src="https://mintcdn.com/astecha/9-qdOMMutmYvfodu/images/conectar-mcp-claude/passo-10.png?fit=max&auto=format&n=9-qdOMMutmYvfodu&q=85&s=67f68084255f77a6db56723f4e4845d6" alt="Conector Astecha conectado, com as permissões das ferramentas" width="1150" height="895" data-path="images/conectar-mcp-claude/passo-10.png" />
    </Frame>
  </Step>
</Steps>

<Check>
  **Tudo certo.** Abra uma conversa nova e peça algo sobre a sua operação, por exemplo: *"Quais são os meus projetos na Astecha?"*.
</Check>

## Precisa de ajuda?

<Card title="Fale com o seu contato Astecha" icon="headset" href="/suporte">
  Se algo não funcionar, entre em contato com o time Astecha. Teremos prazer em ajudar.
</Card>
