Abriendo el portal
Una API de Caminho Anglicano
Consultar estadoEl servidor MCP da a Codex, Claude y otros clientes acceso de lectura al calendario, al leccionario y al Oficio Diario. La autenticación ocurre en el navegador; ninguna clave se pega en la conversación.
Las herramientas consultan el calendario, el leccionario y el Oficio Diario y devuelven los mismos datos estructurados de la API.
https://mcp.caminhoanglicano.com.br/mcpEn la primera conexión, el navegador se abre para que entres con la cuenta del portal. El servidor crea una clave de API y la guarda cifrada.
Instalación
Terminal
Instala el plugin desde el marketplace del repositorio y deja que Claude descubra las herramientas por sí solo.
/plugin marketplace add dodopok/estevao-mcp /plugin install estevao@estevao
La autenticación ocurre en el navegador cuando Claude hace su primera llamada.
Terminal
Añade el endpoint alojado a Codex y completa el flujo OAuth con un solo comando de inicio de sesión.
codex mcp add estevao --url https://mcp.caminhoanglicano.com.br/mcp codex mcp login estevao
El paquete también incluye el manifiesto universal .codex-plugin para instalarlo como plugin.
El endpoint sigue el estándar Streamable HTTP con OAuth 2.1, con descubrimiento automático y registro dinámico de clientes. Cualquier cliente MCP compatible se conecta con la misma URL.
| Cliente | Cómo conectar |
|---|---|
| Claude Code | › claude mcp add --transport http estevao https://mcp.caminhoanglicano.com.br/mcp |
| Claude Code (plugin) | › /plugin marketplace add dodopok/estevao-mcp› /plugin install estevao@estevao |
| Claude Desktop / claude.ai | Ajustes → Conectores → conector personalizado › https://mcp.caminhoanglicano.com.br/mcp |
| Codex CLI | › codex mcp add estevao --url https://mcp.caminhoanglicano.com.br/mcp› codex mcp login estevao |
| Gemini CLI | ~/.gemini/settings.json › {"mcpServers":{"estevao":{"httpUrl":"https://mcp.caminhoanglicano.com.br/mcp","oauth":{"enabled":true}}}} |
| VS Code, Cursor, Windsurf | › {"servers":{"estevao":{"type":"http","url":"https://mcp.caminhoanglicano.com.br/mcp"}}} |
| MCP Inspector | Selecciona el transporte “Streamable HTTP” después de abrir el Inspector. › npx @modelcontextprotocol/inspector› https://mcp.caminhoanglicano.com.br/mcp |
| MCP | › {"type":"http","url":"https://mcp.caminhoanglicano.com.br/mcp"} |
Detalles de interoperabilidad
Los metadatos de descubrimiento se publican en todas las rutas que los clientes suelen buscar (la raíz y bajo /mcp, en las variantes OAuth y OpenID Connect). El registro acepta tanto Dynamic Client Registration como Client ID Metadata Documents. El endpoint de token acepta cliente público, client_secret_post y client_secret_basic. Hay un único ámbito, de solo lectura, y los clientes que piden otros ámbitos siguen funcionando. CORS expone el desafío de autenticación, así que los conectores que corren en el navegador también pueden iniciar el flujo.
El cliente MCP descubre el servidor de autorización a partir del propio endpoint y se registra solo.
El navegador abre la pantalla de consentimiento de Estêvão, donde entras con Google o correo: la misma cuenta de este portal.
Al autorizar, el servidor crea (o reutiliza) una clave de API de tu cuenta y la guarda cifrada.
El cliente recibe un token propio, de vida corta y renovación automática, válido solo para este servidor.
En cada llamada el servidor usa la clave guardada. El token del cliente nunca llega a la API Estêvão.
La conexión necesita un plan
Conectar un cliente MCP crea una clave de API, así que la conexión exige un plan activo — o la cuenta vitalicia de quien ya usaba el portal. Sin plan, la pantalla de consentimiento lo explica en vez de autorizar. Si la suscripción vence, la clave guardada deja de responder y la siguiente autorización vuelve a pedir un plan. Planes
La clave se gestiona por ti
La conexión crea una clave llamada MCP — YYYY-MM-DD en tu cuenta y la guarda cifrada en el servidor. Aparece en el panel de claves, ocupa un espacio del límite de tu plan y registra el uso. Si borras esa clave, la conexión deja de funcionar hasta una nueva autorización.
¿Prefieres ejecutarlo localmente? El mismo servidor funciona en stdio con una clave creada por ti en el panel: sin OAuth y sin depender del endpoint alojado.
claude mcp add estevao --env ESTEVAO_API_KEY=estevao_sua_chave -- npx -y estevao-mcp| Herramienta | Qué hace |
|---|---|
get_liturgical_day | Tiempo, color, año litúrgico, celebración, colecta y lecturas de una fecha. |
get_calendar_month | Cuadrícula del mes: color, celebración y semana de cada día. |
get_year_overview | Estructura del año: tiempos, fiestas móviles y fechas clave. |
get_readings | Lecturas del leccionario (primera, salmo, segunda, evangelio), por servicio si quieres. |
get_lectionary_cycle | Ciclos dominical (A/B/C) y ferial (1/2) de un año. |
get_daily_office | Oficio Diario completo en markdown o JSON estructurado. |
search_celebrations | Búsqueda textual de fiestas, santos y días santos. |
list_celebrations | Santoral con filtros de tipo, movilidad y año. |
get_celebration | Detalle de una celebración: traslado, cálculo, colectas y lecturas. |
list_prayer_books | Libros de oración disponibles; opcionalmente, versiones de la Biblia. |
get_prayer_book_preferences | Preferencias que acepta cada libro, incluidos salmos, cánticos, ciclos y opciones del oficio. |
explain_liturgical_day | Rastro de la decisión: precedencia, traslados, color y elección de cada lectura. |
compare_prayer_books | Comparación lado a lado de 2 a 4 ediciones en el mismo día u oficio. |
Además de las herramientas, el servidor publica recursos (ordo://prayer-books, ordo://bible-versions, ordo://today, ordo://day/, ordo://explain/, ordo://office// y ordo://calendar//key-dates) y cuatro prompts factuales: boletín, explicación de fiesta, explicación de la decisión y comparación entre tradiciones. Todas las herramientas son de solo lectura, y el servidor no genera sermones ni reflexiones devocionales.