MCP

Conectar el servidor MCP

Teddit lleva un servidor MCP integrado. Conéctalo a Claude, Cursor u otro cliente MCP, y tu propia IA podrá leer cada respuesta, fuente y número de tu espacio de trabajo, gestionar prompts y competidores, y ejecutar análisis si la clave lo permite.

Qué obtienes

El servidor forma parte de Teddit. No hay nada que instalar por nuestra parte ni que desplegar.

Elemento	Valor
Dirección	`https://teddit.io/mcp`
Transporte	Streamable HTTP, sin estado: cada petición se sostiene por sí sola, no hay ninguna sesión que mantener abierta.
Autenticación	Una clave de API del espacio de trabajo en la cabecera `Authorization: Bearer tdt_…`
Contenido	30 herramientas, un recurso (`teddit://projects`) y dos plantillas de prompt (`weekly_review`, `grow_prompt_set`). Todos están en la referencia de herramientas.

Cada llamada a una herramienta pasa las mismas comprobaciones que la aplicación web. Una clave nunca puede hacer más de lo que permite su nivel de acceso, y nada de lo que hace una herramienta queda oculto a la aplicación: un análisis iniciado por MCP aparece en el Historial de análisis como cualquier otro.

Leer es gratis. Una herramienta cuesta dinero: start_scan ejecuta un análisis, pagado desde el saldo del espacio de trabajo. rewrite_queries no se cobra, pero necesita un saldo mayor que cero.

Crear una clave

En la aplicación, haz clic en el icono de engranaje de la barra superior y abre la pestaña API y MCP.
Pulsa Crear clave. Dale un nombre que diga dónde se va a usar, por ejemplo “Claude en mi portátil”.
Elige el acceso: Lectura, Lectura + edición o Lectura + análisis.
Copia la clave. Empieza por tdt_ y se muestra una sola vez. Teddit guarda solo una huella de ella y no puede volver a mostrarla.

Cualquiera en el espacio de trabajo puede crear una clave; lo que puede hacer depende de su rol. Una clave pertenece a un solo espacio de trabajo. Mientras el diálogo con la nueva clave está abierto, los fragmentos de configuración de la página API y MCP se rellenan con ella, listos para copiar.

Para retirar una clave, pulsa el icono de papelera junto a ella. Deja de funcionar al momento. Más sobre claves: Autenticación.

Claude

Claude Code

Un comando añade el servidor por HTTP:

claude mcp add --transport http teddit https://teddit.io/mcp \
  --header "Authorization: Bearer tdt_…"

Claude Desktop

Claude Desktop inicia los servidores MCP como programas locales desde su archivo de configuración. Un pequeño puente, el paquete de código abierto mcp-remote, lo conecta a la dirección de Teddit y envía la clave. Necesita Node.js. Añade esto a claude_desktop_config.json y reinicia Claude:

{
  "mcpServers": {
    "teddit": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://teddit.io/mcp", "--header", "Authorization:${TEDDIT_AUTH}"],
      "env": {
        "TEDDIT_AUTH": "Bearer tdt_…"
      }
    }
  }
}

La clave va en TEDDIT_AUTH, después de Bearer y un espacio.

ChatGPT

ChatGPT añade servidores MCP remotos como conectores, por dirección. Para conectar Teddit, el conector tiene que enviar tu clave en la cabecera Authorization:

Name:  Teddit
URL:   https://teddit.io/mcp
Auth:  Bearer tdt_…

Teddit acepta una clave en la cabecera Authorization y nada más. No tiene inicio de sesión OAuth. Un cliente cuyo formulario de conector solo ofrece OAuth, o ninguna forma de enviar una cabecera, no puede conectarse directamente.

Cursor y otros clientes

Cualquier cliente que hable MCP por Streamable HTTP y pueda enviar una cabecera funciona. Para Cursor, pon esto en .cursor/mcp.json:

{
  "mcpServers": {
    "teddit": {
      "type": "http",
      "url": "https://teddit.io/mcp",
      "headers": {
        "Authorization": "Bearer tdt_…"
      }
    }
  }
}

Para un cliente que configures a mano, estos son los tres datos que necesita:

la dirección https://teddit.io/mcp;
el transporte: Streamable HTTP;
la cabecera Authorization: Bearer tdt_… en cada petición.

Un cliente que solo puede iniciar programas locales puede usar el puente mcp-remote mostrado en Claude Desktop.

Comprobar la conexión

Pregunta a tu IA: “Usa Teddit y dime a qué espacio de trabajo estás conectado.” Debería llamar a whoami y responder con el nombre del espacio de trabajo y el nivel de acceso de la clave.

Para probar una clave sin ningún cliente, llama a la API directamente:

curl https://teddit.io/api/whoami \
  -H "Authorization: Bearer tdt_…"

Qué ves	Qué significa
HTTP 401 desde `/mcp`	No se envió ninguna clave, la cabecera no tiene la forma `Bearer tdt_…`, o la clave fue revocada. Un inicio de sesión en el navegador no cuenta aquí; la dirección MCP solo admite claves.
Una herramienta responde `Error: You do not have permission to do that.`	El nivel de acceso de la clave es demasiado bajo para esa herramienta. Crea una clave con más acceso.
Una herramienta responde `Error: Project not found.`	El id del sitio es incorrecto, o el sitio pertenece a otro espacio de trabajo. Los ids vienen de `list_projects`.

Qué puede hacer una clave

Acceso	Herramientas que puede usar
Lectura	Todo lo que lee: informes, tendencias, prompts y sus respuestas, competidores, páginas, historial y progreso de análisis, estimaciones de coste, gráficos.
Lectura + edición	Lo anterior, y además: añadir, editar, pausar, importar y eliminar prompts; añadir, editar y quitar competidores; cambiar los ajustes de un sitio; volver a leer el sitemap.
Lectura + análisis	Lo anterior, y además: iniciar y cancelar análisis, reescribir consultas importadas como preguntas, y añadir un sitio.

No puedes crear una clave con más acceso del que tienes tú. Los análisis iniciados con una clave se pagan desde el mismo saldo y cuentan para los mismos límites que los iniciados en la aplicación, y se registran a nombre de la persona que creó la clave.

Siguiente: la referencia de herramientas y algunas preguntas de ejemplo.

Anterior‹ Acceso de rastreadores de IA SiguienteReferencia de herramientas ›