Skip to content

Ligar o Eidograph ao ChatGPT ​

A aplicação de ambiente de trabalho do ChatGPT pode ler e editar figuras do Eidograph diretamente através de MCP. Este guia utiliza o Eidograph e o ChatGPT no mesmo computador Windows, com uma ligação Streamable HTTP.

As capturas mostram a configuração real numa interface em inglês, pelo que os nomes dos campos são mantidos. As ferramentas têm de ser executadas num ambiente que consiga aceder ao servidor local do Eidograph: 127.0.0.1 num ambiente remoto ou na nuvem não corresponde ao seu computador Windows.

1. Iniciar o servidor do Eidograph ​

  1. Abra a aplicação Eidograph instalada e aceda a Definições › Servidor MCP / REST. Ative o servidor e confirme que está em execução.
  2. Copie o endereço MCP completo apresentado. O predefinido é http://127.0.0.1:14159/mcp; se alterou a porta, utilize o endereço efetivamente indicado.
  3. Ative as ferramentas necessárias. Em Figuras, confirme que o ponto de exposição da figura pretendida está preenchido, permitindo o acesso a clientes externos.
  4. Mantenha o Eidograph aberto durante a ligação. A escuta local predefinida é suficiente para aplicações no mesmo computador.

2. Adicionar MCP no ChatGPT ​

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

Definiçõ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

Conserve o sufixo /mcp. /api/v1 é o endereço da API REST, não o ponto de acesso MCP necessário neste formulário.

Se Exigir um token de acesso estiver ativo no Eidograph, adicione em Headers a chave Authorization com o valor Bearer <token>, substituindo <token> pelo token real. Este cabeçalho não é necessá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. Utilize este campo apenas se a variável estiver configurada no ambiente de execução do ChatGPT; deixe-o vazio se definir o cabeçalho diretamente.

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

3. Guardar e ativar a ligação ​

Clique em Save. Em MCPs, confirme que aparece eidograph com o interruptor ativo. Se o cliente pedir para recarregar ou reiniciar, siga as instruções e abra uma nova conversa Work para utilizar as ferramentas.

Lista MCPs do ChatGPT com o servidor eidograph ativo

4. Ler primeiro e desenhar depois ​

Comece por um pedido apenas de leitura para confirmar a figura:

text
Utiliza apenas o conector eidograph.
Chama list_figures para listar as figuras acessíveis e depois get_script para ler o script atual.
Descreve brevemente a figura. Não alteres nem exportes nada.

Depois de verificar o nome da figura e o script recebidos, peça uma construção:

text
Utiliza o eidograph para criar uma figura 2D independente sem alterar as restantes.
Desenha um triângulo isósceles ABC, deriva M como ponto médio de BC e traça AM.
Usa linhas pretas e etiquetas claras nos vértices; representa AM a tracejado.
Consulta primeiro list_commands e verifica o resultado com list_diagnostics.
É uma prova para alunos: não marques um ângulo reto nem incluas a demonstração.

Verifique a área de desenho, as etiquetas e os diagnósticos. Pode também confirmar as chamadas na atividade externa recente das definições do servidor. Se o ambiente de trabalho do ChatGPT permitir criar documentos, peça-lhe que obtenha a imagem, gere um DOCX e o disponibilize como ficheiro que pode abrir na conversa, sem indicar um caminho de gravação. As ferramentas do Eidograph fornecem a imagem; o ambiente do ChatGPT cria o documento.

5. Resolver problemas de ligação ​

  • Não liga: confirme que a aplicação e o servidor estão em execução, que URL e porta coincidem e que o ambiente das ferramentas consegue aceder ao computador.
  • Resposta 401: verifique o token e o prefixo Bearer ; não introduza o token no campo do nome da variável.
  • A figura pretendida não aparece: verifique o projeto ativo, o ponto de exposição e as permissões das ferramentas.
  • Uma alteração não tem efeito: confirme a figura ativa, consulte list_diagnostics e a atividade externa e corrija o pedido segundo 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 as capacidades dependem do cliente atual; veja a documentação oficial da OpenAI sobre MCP.