Guia do Conector de IA do NetSuite: Configuração do MCP

O Oracle NetSuite é há muito tempo uma plataforma de planeamento de recursos empresariais (ERP) baseada na nuvem para pequenas e médias empresas. No entanto, a interface de utilizador do seu website é infame pela sua curva de aprendizagem acentuada, navegação complexa com muitos cliques e estruturas de relatórios rígidas.

Com o lançamento recente do NetSuite AI Connector Service, os utilizadores podem aproveitar o Model Context Protocol (MCP) e os assistentes de IA (inteligência artificial) para fazer perguntas diretamente em linguagem natural e obter respostas em tempo real a partir de dados financeiros e operacionais.

Como Funciona o Conector de IA do NetSuite MCP

O MCP do NetSuite expõe um conjunto de ferramentas à IA, como a execução de consultas SuiteQL, leitura de pesquisas guardadas (Saved Searches) e relatórios, ou execução de operações de registo, como a criação de um novo registo de cliente. Todas as ferramentas são controladas pelos permissões nativos baseados em funções do NetSuite.

Quando um utilizador faz uma pergunta em linguagem natural, a IA utiliza o Model Context Protocol (MCP) para traduzir o pedido em operações estruturadas que o NetSuite compreende. O NetSuite executa as operações utilizando as permissões do utilizador, e os resultados são devolvidos à IA para análise e apresentação.

Guia de Configuração do Conector de IA do NetSuite

1. Ativar o Server SuiteScript e o REST Web Services
   1. Aceda a Setup > Company > Enable Features (Configuração > Empresa > Ativar Funcionalidades).
   2. No separador secundário SuiteCloud:
      • Em SuiteScript, selecione a caixa Server SuiteScript.
      • Em SuiteTalk (Serviços Web), selecione a caixa REST Web Services.
   3. Clique em Guardar (Save).
2. Instale primeiro o NetSuite MCP Standard Tools. Clique em Customization > SuiteCloud Development > SuiteApp Marketplace (Personalização > Desenvolvimento SuiteCloud > Mercado de SuiteApps).
3. Pesquise por NetSuite MCP Standard Tools.
4. Assim que estiver instalado, verá o estado 'Installed' (Instalado) à direita.
5. Siga as mesmas instruções para instalar o 'NetSuite AI Connector Service Companion'.
6. Configurar um Registo de Integração
   1. Aceda a Setup > Integration > Manage Integrations.
   2. Crie um Registo de Integração para o ChatGPT e regressaremos depois com o token_id real:
7. Crie uma função personalizada para o MCP com as permissões mínimas e atribua-a aos utilizadores. Ex.:

Como Integrar o NetSuite MCP com o ChatGPT

1. Clique em 'Settings' (Definições).
2. Clique em 'Apps' > 'Advanced settings' (Definições avançadas).
3. Ative o 'Developer mode' (Modo de programador) e clique em 'Create app' (Criar aplicação). s
4. Introduza os detalhes. Em Connection, introduza https://<account_id>.suitetalk.api.netsuite.com/services/mcp/v1/all.
5. Clique em 'Create'. Uma vez integrado, verá o seguinte pop-up.
6. Clique em 'Sign in with NetSuite MCP' (Iniciar sessão com o NetSuite MCP).
7. Clique no botão 'Continue' para conceder permissões.

Como Integrar o NetSuite MCP com o Claude AI

1. Clique em 'Customize' (Personalizar).
2. Clique em 'Connect your apps' (Ligar as suas aplicações).
3. Pesquise por 'NetSuite'.
4. Clique em 'NetSuite' e introduza o URL do servidor: https://<account_id>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools. Substitua <account_id> pelo ID real da sua conta.
5. Clique no botão 'Continue'.
6. Clique em 'Continue' para autenticar o conector.

Casos de Uso de IA do NetSuite

Caso de Uso no ChatGPT: Mostrar faturas vencidas há mais de 30 dias no NetSuite

• O ChatGPT criou a consulta SuiteQL e executou-a. Isto é extremamente prático e poupa imenso tempo em comparação com a criação de um relatório através da interface web do NetSuite.

Caso de Uso no ChatGPT e Claude: Consegue desenhar as vendas dos últimos 30 dias num gráfico de linhas?

• O ChatGPT não conseguiu gerar o gráfico de linhas.
• Experimentei no Claude e funcionou. A diferença pode dever-se às capacidades do modelo de linguagem de grande dimensão (LLM).

Caso de Uso no Claude: Criar um registo de cliente

• Uma verificação rápida na interface do NetSuite confirma que o registo foi criado com sucesso.
• A execução no ChatGPT mostra que o registo está disponível:

Caso de Uso no Claude: Executar Consulta SuiteQL

• A consulta SuiteQL pode ser executada diretamente.

Considerações Finais sobre o Conector de IA do NetSuite

A maior vantagem de utilizar o MCP é para utilizadores que não têm perfil técnico suficiente para criar relatórios complexos. Estes utilizadores podem usar linguagem corrente para interrogar os dados e pedir à IA para apresentar o relatório exatamente como desejam.

Para evitar ataques de injeção de prompt e o uso indevido de operações de escrita, conceda apenas permissões de escrita a determinados registos e transações. Quando a IA usa o MCP para atualizar ou criar um registo, executa-o como SuiteScript do lado do servidor, o que ignora totalmente qualquer script do lado do cliente ou validação de força.

Referências:

• Instalação do SuiteApp MCP Standard Tools
• Perguntas Frequentes sobre o Serviço do Conector de IA do NetSuite
• Ligar ao Serviço do Conector de IA do NetSuite