Documentação MCP

O servidor expõe três ferramentas somente-leitura:

Abra Settings → Developer → Edit Config e adicione o servidor abaixo em mcpServers. O Claude usa um proxy mcp-remote para servidores HTTP.

{
  "mcpServers": {
    "ritmo-digital": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://ritmodigital.tec.br/mcp"]
    }
  }
}

Reinicie o Claude Desktop. As três ferramentas aparecerão no ícone de plugins do chat.

Em Settings → Connectors → Add custom connector, cole a URL abaixo. O ChatGPT detecta automaticamente o transporte Streamable HTTP.

https://ritmodigital.tec.br/mcp

Deixe a autenticação como None e habilite o conector na conversa desejada.

Edite ~/.cursor/mcp.json (ou Settings → MCP → Add new server) com:

{
  "mcpServers": {
    "ritmo-digital": {
      "url": "https://ritmodigital.tec.br/mcp"
    }
  }
}

Crie .vscode/mcp.json no workspace:

{
  "servers": {
    "ritmo-digital": {
      "type": "http",
      "url": "https://ritmodigital.tec.br/mcp"
    }
  }
}

Abra o Copilot Chat em modo Agent e as ferramentas ficarão disponíveis.

O servidor segue a especificação MCP Streamable HTTP — sempre envie Accept: application/json, text/event-stream.

1. Listar ferramentas

curl -X POST https://ritmodigital.tec.br/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

2. Chamar list_services

curl -X POST https://ritmodigital.tec.br/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_services",
      "arguments": {}
    }
  }'

3. Chamar get_contact_info

curl -X POST https://ritmodigital.tec.br/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "get_contact_info",
      "arguments": {}
    }
  }'

Exemplo em TypeScript usando o SDK oficial @modelcontextprotocol/sdk:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://ritmodigital.tec.br/mcp")
);

const client = new Client({ name: "meu-app", version: "1.0.0" });
await client.connect(transport);

const tools = await client.listTools();
console.log(tools);

const result = await client.callTool({
  name: "list_blog_posts",
  arguments: {},
});
console.log(result.content);