Abrindo o portal
Uma API do Caminho Anglicano
Consultar statusO servidor MCP dá ao Codex, Claude e outros clientes acesso de leitura ao calendário, ao lecionário e ao Ofício Diário. A autenticação acontece no navegador; nenhuma chave precisa ser colada na conversa.
As ferramentas consultam o calendário, o lecionário e o Ofício Diário e devolvem os mesmos dados estruturados da API.
https://mcp.caminhoanglicano.com.br/mcpNa primeira conexão, o navegador abre para você entrar com a conta do portal. O servidor cria uma chave da API e a guarda cifrada.
Instalação
Terminal
Instale o plugin pelo marketplace do repositório e deixe o Claude descobrir as ferramentas automaticamente.
/plugin marketplace add dodopok/estevao-mcp /plugin install estevao@estevao
A autenticação acontece no navegador quando o Claude fizer a primeira chamada.
Terminal
Adicione o endpoint hospedado ao Codex e complete o fluxo OAuth com um único comando de login.
codex mcp add estevao --url https://mcp.caminhoanglicano.com.br/mcp codex mcp login estevao
O pacote também inclui o manifesto universal .codex-plugin para instalação como plugin.
O endpoint segue o padrão Streamable HTTP com OAuth 2.1, incluindo descoberta automática e registro dinâmico de cliente. Qualquer cliente MCP compatível conecta com a mesma URL.
| Cliente | Como 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 | Selecione o transporte “Streamable HTTP” depois de abrir o Inspector. › npx @modelcontextprotocol/inspector› https://mcp.caminhoanglicano.com.br/mcp |
| MCP | › {"type":"http","url":"https://mcp.caminhoanglicano.com.br/mcp"} |
Detalhes de interoperabilidade
A metadata de descoberta é publicada em todos os caminhos que os clientes costumam procurar (raiz e sob /mcp, nas variantes OAuth e OpenID Connect). O registro aceita tanto Dynamic Client Registration quanto Client ID Metadata Documents. A autenticação no endpoint de token aceita cliente público, client_secret_post e client_secret_basic. Há apenas um escopo, somente leitura, e clientes que pedem escopos diferentes continuam funcionando. O CORS expõe o desafio de autenticação, então conectores executados no navegador também conseguem iniciar o fluxo.
O cliente MCP descobre o servidor de autorização a partir do próprio endpoint e se registra sozinho.
O navegador abre a tela de consentimento do Estêvão, onde você entra com Google ou e-mail — a mesma conta deste portal.
Ao autorizar, o servidor cria (ou reaproveita) uma chave de API da sua conta e a guarda cifrada.
O cliente recebe um token próprio, com validade curta e renovação automática, que vale só para este servidor.
A cada chamada, o servidor usa a chave guardada. O token do cliente nunca chega à API Estêvão.
A conexão precisa de um plano
Conectar um cliente MCP cria uma chave de API, então a conexão exige um plano ativo — ou a conta vitalícia de quem já usava o portal. Sem plano, a tela de consentimento explica isso em vez de autorizar. Se a assinatura vencer, a chave guardada para de responder e a próxima autorização pede um plano de novo. Planos
A chave é gerenciada para você
A conexão cria uma chave chamada MCP — YYYY-MM-DD na sua conta e a guarda cifrada no servidor. Ela aparece no painel de chaves, consome uma vaga do limite do seu plano e registra o uso. Se você apagar essa chave, a conexão deixa de funcionar até uma nova autorização.
Prefere rodar localmente? O mesmo servidor funciona em stdio com uma chave criada por você no painel — sem OAuth, sem depender do endpoint hospedado.
claude mcp add estevao --env ESTEVAO_API_KEY=estevao_sua_chave -- npx -y estevao-mcp| Ferramenta | O que faz |
|---|---|
get_liturgical_day | Tempo, cor, ano litúrgico, celebração, coleta e leituras de uma data. |
get_calendar_month | Grade do mês: cor, celebração e semana de cada dia. |
get_year_overview | Estrutura do ano: tempos, festas móveis e datas-chave. |
get_readings | Leituras do lecionário (primeira, salmo, segunda, evangelho), por serviço se quiser. |
get_lectionary_cycle | Ciclos dominical (A/B/C) e ferial (1/2) de um ano. |
get_daily_office | Ofício Diário completo em markdown ou JSON estruturado. |
search_celebrations | Busca textual de festas, santos e dias santos. |
list_celebrations | Santoral com filtros de tipo, mobilidade e ano. |
get_celebration | Detalhe de uma celebração: transferência, cálculo, coletas e leituras. |
list_prayer_books | Livros de oração disponíveis; opcionalmente, versões da Bíblia. |
get_prayer_book_preferences | Preferências aceitas por cada livro, incluindo salmos, cânticos, ciclos e opções do ofício. |
explain_liturgical_day | Trilha de decisão: precedência, transferências, cor e escolha de cada leitura. |
compare_prayer_books | Comparação lado a lado de 2 a 4 edições no mesmo dia ou ofício. |
Além das ferramentas, o servidor publica recursos (ordo://prayer-books, ordo://bible-versions, ordo://today, ordo://day/, ordo://explain/, ordo://office// e ordo://calendar//key-dates) e quatro prompts factuais: boletim, explicação de festa, explicação da decisão e comparação entre tradições. Todas as ferramentas são somente leitura, e o servidor não gera sermões nem reflexões devocionais.