Cómo dejar una nota interna en WhatsApp con Claude Code, Cursor o Codex
add_note anota el chat en la bandeja y no le escribe al cliente. No existe POST /api/v2/notes. Claude Code, Cursor, Codex y Grok usan el mismo MCP. ChatGPT Pro no anota.
Respuesta corta: la nota interna se deja con la herramienta add_note del MCP de Waspy, POST https://api.waspytech.com/mcp. Pide conversationId y body (hasta 5.000 caracteres) y el scope conversations:write. No le manda un WhatsApp al cliente. No existe POST /api/v2/notes.
El 17 de noviembre de 2026 un POST a esa URL sin clave respondió 401 {"error":"unauthorized"}. Un GET respondió 405 y el texto Este servidor MCP responde por POST. No mantiene una sesión abierta. La guía del conector está en docs.waspytech.com. Cómo se conecta cada cliente, en Claude, ChatGPT y Cursor.
La llamada
curl -sS -X POST https://api.waspytech.com/mcp \
-H "Authorization: Bearer $WASPY_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "add_note",
"arguments": {
"conversationId": "UUID-DEL-CHAT",
"body": "Pidió cambio de talle. Esperar el comprobante antes de reservar."
}
}
}'
Reemplazá UUID-DEL-CHAT por el id que devolvió search o search_conversations. No lo inventes. El cuerpo se recorta de espacios. Si body o conversationId vienen vacíos, el texto es Falta body. o Falta conversationId.
Si el pedido es un JSON-RPC válido, el HTTP es 200. result.structuredContent.note trae tres campos: id, body y createdAt. El nombre de quien anotó no vuelve en ese JSON: se guarda para el panel. result.content[0].text es el mismo objeto en texto.
| Señal | Qué pasa |
|---|---|
| Sin token, o token que no existe | HTTP 401, unauthorized o invalid_token |
| Nota de más de 5000 caracteres | HTTP 200, isError, La nota es demasiado larga (máximo 5000 caracteres). |
| Chat de otra cuenta, borrado, o un grupo | HTTP 200, isError, No encuentro esa conversación en esta cuenta. |
La conexión no tiene conversations:write | HTTP 200, isError, Esta conexión no tiene el permiso conversations:write. Volvé a conectar Waspy y aceptá ese permiso. |
| Cuenta bloqueada por pago | HTTP 402 |
| Más de 120 llamadas por minuto | HTTP 429 |
Idempotency-Key en esta herramienta. Ese header es de POST /api/v2/messages.
Quién figura como autor
| Cómo entrás | Autor en el panel | createdBy |
|---|---|---|
| OAuth (Claude, Claude Code, ChatGPT en plan que escribe, Codex) | El nombre de la persona en Waspy | El id de ese usuario |
API key wspy_ (Cursor con header, Grok, n8n) | El nombre de la clave | Vacío |
| Nombre vacío | Conector | Según la fila de arriba |
tenantId no cambia de cuenta. La cuenta sale del token.
Claude Code, Cursor, Codex, Grok y n8n
La documentación de Claude Code pide type: "http" cuando la entrada tiene URL. Sin type, la trata como un proceso local y la saltea. En la raíz del proyecto:
{
"mcpServers": {
"waspy": {
"type": "http",
"url": "https://api.waspytech.com/mcp"
}
}
}
Sin header, el cliente usa el OAuth que publica Waspy. La nota queda a nombre de la persona que aceptó el permiso. Si preferís una clave, el header es Authorization: Bearer wspy_... y el autor pasa a ser el nombre de esa clave. El mismo JSON de tools/call entra en los dos caminos.
Cursor, en Settings → MCP, usa la URL https://api.waspytech.com/mcp. Si la versión arranca OAuth, el header no hace falta: es el camino que describe la guía del conector. Con header, vale la clave.
Codex hereda la app MCP que creaste en ChatGPT. En los planes Pro de ChatGPT el conector es solo lectura: no anota. Anotar está en Business, Enterprise y Edu. En la pantalla de consentimiento, “Solo lectura y notas” deja la nota y saca el envío al cliente.
Grok acepta la misma URL, con el OAuth que ofrezca o con el header Bearer. n8n no tiene un nodo de Waspy: el nodo MCP Client apunta a https://api.waspytech.com/mcp, transporte Streamable HTTP, y el mismo Bearer. Para anotar, la clave necesita conversations:write. Para buscar el chat antes, también conversations:read.
El mismo cuerpo entra en Apps Script:
function anotarChat(conversationId, texto) {
var clave = PropertiesService.getScriptProperties().getProperty('WASPY_API_KEY');
var res = UrlFetchApp.fetch('https://api.waspytech.com/mcp', {
method: 'post',
contentType: 'application/json',
headers: {
Authorization: 'Bearer ' + clave,
Accept: 'application/json, text/event-stream'
},
payload: JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'tools/call',
params: {
name: 'add_note',
arguments: { conversationId: conversationId, body: texto }
}
}),
muteHttpExceptions: true
});
return res.getContentText();
}
Esa función no manda un WhatsApp. Cómo se cita el chat antes de anotar está en search y fetch.
Qué no hace, comparado con mandar el mensaje
| Querés | Herramienta | ¿Le escribe al cliente? |
|---|---|---|
| Dejarle al equipo “falta el talle” | add_note | No |
| Contestar dentro de las 24 h | send_message | Sí. Es un mensaje de servicio |
| Avisar fuera de la ventana | send_template | Sí. Es una plantilla, y Meta la cobra |
| Leer el hilo | fetch o get_conversation_messages | No |
En Argentina, desde el 1 de octubre de 2026, el texto que sí se envía dentro de la ventana entra en las 1.000 de servicio por número y por mes. Desde el 1.001, alrededor de ARS 37,68 (~US$0,026). La nota no entra en esa cuenta: no es un mensaje. La tarifa está en la rate card.
La API pública y el conector están en Scale (US$150 por mes) y Enterprise. Diez días sin tarjeta, en el registro. Los planes están en Planes y la referencia, en la página de la API.
