Skip to content

Conectar o Eidograph ao ChatGPT ​

O aplicativo de desktop do ChatGPT pode ler e editar figuras do Eidograph diretamente por MCP. Este guia usa o Eidograph e o ChatGPT no mesmo computador Windows, com uma conexão Streamable HTTP.

As capturas mostram a configuração real em uma interface em inglês; por isso, os nomes dos campos são mantidos. As ferramentas precisam rodar em um ambiente que alcance o servidor local do Eidograph: 127.0.0.1 em um ambiente remoto ou na nuvem não corresponde ao seu computador Windows.

1. Iniciar o servidor do Eidograph ​

  1. Abra o aplicativo Eidograph instalado e acesse Configurações › Servidor MCP / REST. Ative o servidor e confirme que ele está em execução.
  2. Copie o endereço MCP completo exibido. O padrão é http://127.0.0.1:14159/mcp; se você alterou a porta, use o endereço mostrado nas configurações.
  3. Ative as ferramentas necessárias. Em Figuras, confirme que o ponto de exposição da figura desejada está preenchido, permitindo acesso a clientes externos.
  4. Mantenha o Eidograph aberto durante a conexão. A escuta local padrão é suficiente para aplicativos no mesmo computador.

2. Adicionar MCP no ChatGPT ​

Abra Settings → Plugins → MCPs, clique em Add no canto superior direito e selecione Add MCP server.

Configurações de Plugins do ChatGPT com MCPs selecionado e o menu Add MCP server aberto

Preencha o formulário Connect to a custom MCP:

CampoValor
Nameeidograph
TypeStreamable HTTP
URLO endereço MCP completo do Eidograph, por exemplo http://127.0.0.1:14159/mcp

Mantenha o sufixo /mcp. /api/v1 é o endereço da API REST, não o endpoint MCP solicitado neste formulário.

Se Exigir um token de acesso estiver ativado no Eidograph, adicione em Headers a chave Authorization com o valor Bearer <token>, substituindo <token> pelo token real. Esse cabeçalho é desnecessário quando a autenticação por token está desativada.

Bearer token env var recebe o nome de uma variável de ambiente, não o próprio token. Use esse campo somente se a variável estiver configurada no ambiente de execução do ChatGPT; deixe-o vazio ao definir o cabeçalho diretamente.

Formulário MCP do ChatGPT com eidograph, Streamable HTTP e o endereço MCP local

3. Salvar e ativar a conexão ​

Clique em Save. Na lista MCPs, confirme que eidograph aparece com a chave ativada. Se o cliente pedir para recarregar ou reiniciar, siga as instruções e abra uma nova conversa Work para usar as ferramentas.

Lista MCPs do ChatGPT com o servidor eidograph ativado

4. Ler primeiro e desenhar depois ​

Comece com uma solicitação somente de leitura para confirmar a figura:

text
Use somente o conector eidograph.
Chame list_figures para listar as figuras acessíveis e depois get_script para ler o script atual.
Descreva brevemente a figura. Não modifique nem exporte nada.

Depois de conferir o nome e o script retornados, peça uma construção:

text
Use o eidograph para criar uma figura 2D separada sem alterar as demais.
Desenhe um triângulo isósceles ABC, derive M como ponto médio de BC e trace AM.
Use linhas pretas e rótulos claros nos vértices; represente AM com linha tracejada.
Consulte primeiro list_commands e confira o resultado com list_diagnostics.
É uma prova para alunos: não marque um ângulo reto nem inclua a demonstração.

Confira o desenho real, os rótulos e os diagnósticos. Você também pode verificar as chamadas na atividade externa recente das configurações do servidor. Se o ambiente do ChatGPT permitir gerar documentos, peça que obtenha a imagem, crie um DOCX e forneça um arquivo que possa ser aberto no chat, sem indicar um caminho de salvamento. As ferramentas do Eidograph fornecem a imagem; o ambiente do ChatGPT cria o documento.

5. Solucionar problemas de conexão ​

  • Não conecta: confira se o aplicativo e o servidor estão em execução, se URL e porta coincidem e se o ambiente das ferramentas alcança este computador.
  • Resposta 401: confira o token e o prefixo Bearer ; não coloque o token no campo do nome da variável.
  • A figura desejada não aparece: confira o projeto ativo, o ponto de exposição e as permissões das ferramentas.
  • Uma edição não tem efeito: confirme a figura ativa, consulte list_diagnostics e a atividade externa e corrija a solicitação conforme o erro.

Consulte MCP, REST e o agente integrado e a referência da API REST para detalhes sobre ferramentas e permissões. Os menus e os recursos dependem do cliente atual; veja a documentação oficial da OpenAI sobre MCP.