MapitDesarrolladores Beta mapit.me ↗

Asistentes y agentes de IA

Usa Mapit con IA

Dos formas de usar Mapit con IA: pregúntale a un asistente por tu propia moto, o haz que un agente de programación escriba el código que la lee.

Beta, gratis por ahora. Mi Mapit y el servicio que hay detrás son una beta: pueden cambiar o dejar de funcionar, no tienen garantía de disponibilidad y hoy Mapit no los cobra. No dependas de ellos para emergencias ni para recuperar una moto robada: para eso, usa la app de Mapit. Consulta las condiciones de la beta.

Pregúntale a un asistente por tu moto

Mi Mapit conecta un asistente de IA con tu propia cuenta de Mapit. Pregúntale «¿Dónde está mi moto?», «¿Qué rutas hice ayer?» o «¿Cuándo termina mi suscripción?». Inicias sesión con tu cuenta de Mapit en la página de Mapit y eliges qué puede ver el asistente. Nunca recibe tu contraseña.

Plugin o conector

Mi Mapit se ofrece de dos formas. El plugin reúne el conector Mi Mapit y dos skills. El marketplace mapit-iot/ai-plugin (un repositorio de GitHub) se añade en Claude Code y Codex, más abajo. En claude.ai, un administrador de la organización lo añade en Ajustes de la organización > Plugins y skills > Marketplaces, desde una copia privada (ver claude.ai más abajo). Si tu asistente no admite plugins, añade en su lugar el conector con su URL, como en claude.ai y ChatGPT más abajo.

claude.ai

En Ajustes, abre Conectores y añade un conector personalizado llamado Mi Mapit con la URL https://api.mapit.me/mcp. Después conéctalo e inicia sesión con tu cuenta de Mapit.

Los propietarios de Team y Enterprise pueden dar el plugin a toda la organización: en Ajustes de la organización, abre Plugins y skills, luego Marketplaces, y añade el repositorio de GitHub que contiene una copia de mapit-iot/ai-plugin. Anthropic solo admite ahí repositorios privados o internos, así que antes cópialo a un repositorio privado de la organización. Los demás añaden el conector como arriba.

ChatGPT

Añade un conector personalizado (una aplicación que usa MCP) llamado Mi Mapit con la URL https://api.mapit.me/mcp e inicia sesión con tu cuenta de Mapit. Dónde están los conectores personalizados en ChatGPT depende de tu plan y de la versión de la aplicación.

Claude Code

Instala el plugin de Mapit desde el marketplace mapit-iot/ai-plugin:

/plugin marketplace add mapit-iot/ai-plugin
/plugin install mapit@mapit

Después ejecuta /mcp, elige plugin:mapit:my-mapit e inicia sesión. El plugin añade también dos skills que ayudan al asistente a responder preguntas sobre tu moto y a calcular totales de tus rutas.

OpenAI Codex

Instala el plugin desde el mismo marketplace mapit-iot/ai-plugin:

codex plugin marketplace add mapit-iot/ai-plugin
codex plugin add mapit@mapit

Después inicia sesión con tu cuenta de Mapit la primera vez que lo uses.

Cualquier otro cliente MCP

Añade un servidor MCP remoto con la URL https://api.mapit.me/mcp. Usa el transporte Streamable HTTP e inicio de sesión con OAuth: el cliente abre la página de inicio de sesión de Mapit, tú lo autorizas y guarda un token, nunca tu contraseña.

https://api.mapit.me/mcp

Qué puede y qué no puede hacer el asistente

Claude, ChatGPT y los demás asistentes conectados de esta forma están en la lista de aplicaciones aprobadas. El uso es para tus fines personales y no comerciales, según las condiciones de uso de la API y el aviso de privacidad de la API.

Programa con un agente de IA

Dale a tu agente de programación estas direcciones. Cada página de la documentación está también en Markdown: añade .md a su dirección. Los tres archivos de abajo están en inglés, como las instrucciones para el agente; las copias en Markdown de estas páginas están en español.

Instrucciones para el agente

Pega esto en las instrucciones de tu agente (por ejemplo, AGENTS.md o CLAUDE.md) o al principio de una tarea:

You are writing code against the Mapit API (beta).
Docs index: https://developers.mapit.me/llms.txt
All docs in one file: https://developers.mapit.me/llms-full.txt
OpenAPI spec: https://developers.mapit.me/openapi.json

- Base URL: https://api.mapit.me/v1
- Auth: send a personal key as "Authorization: Bearer $MAPIT_KEY". Read the key
  from an environment variable. Never hard-code it, print it or log it.
- Rate limit: 30 requests a minute per key or access token, for the REST API and the MCP connector. Bursts above it may be tolerated, never rely on them. On 429, wait Retry-After seconds.
  Poll /status at most once a minute. See https://developers.mapit.me/limits.md
- Every 200 answer has an ETag: send it back in If-None-Match. 304 means
  nothing changed.
- Version 1 only gains fields: ignore fields you do not know.
- Ids and cursors are opaque: store them, never build or parse them.
  Follow nextCursor until it is null.
- Positions are last reported, not live: show when (lastLocationAt).
- Location and routes need permission on the key: 403 means it lacks it.
- Read-only, except disconnecting apps and keys. Never call DELETE unless
  the user asks.
- Personal, non-commercial use: the user's own vehicles only.
- Python: use the aiomapit package instead of raw HTTP.

Python: aiomapit

En Python, lo más rápido es aiomapit, el cliente asíncrono oficial de Mapit (Python 3.12 o posterior). Tiene tipos, se encarga de la paginación y es el que usa la integración de Home Assistant. Antes, crea una clave personal.

pip install aiomapit
import asyncio, os
from aiomapit import MapitClient

async def main():
    async with MapitClient(os.environ["MAPIT_KEY"]) as client:
        async for status in client.iter_statuses():
            if status.state:
                print(status.vehicle_id, status.state.latitude, status.state.longitude)

asyncio.run(main())

Con otros lenguajes, puedes generar un cliente a partir de la referencia o del archivo OpenAPI.