convez.ai
MCP ServerIntegração & APIsIntermediário
CorgiCorner

Tickward MCP

CorgiCorner/tickward-mcp

Integração MCP para gerenciar projetos e timers do Tickward

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra a API pública do Tickward, permitindo gerenciamento de projetos, timers, espaços e webhooks via Claude. Funciona como adaptador fino que se conecta à API REST versioned após autenticação OAuth 2.1 com PKCE, sem acesso direto ao banco de dados.

Instalação

$npx convez-ai CorgiCorner/tickward-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerenciar projetos e timers do Tickward através de Claude
  • Automatizar criação e atualização de espaços de trabalho
  • Configurar e gerenciar webhooks e compartilhamento de links

Veredito

MCP server bem estruturado para Tickward com arquitetura limpa baseada em API REST. Bom para equipes que usam Tickward e precisam de integração com Claude via protocolo MCP, com suporte a deploy em Cloudflare Workers.

README

A tradução para o português deste README ainda está na fila.

tickward MCP

OAuth MCP server for the tickward public API.

The server is intentionally a thin edge adapter. It does not connect to the tickward database and does not implement business logic. Tools call the versioned REST API under /api/v1 after the user completes the tickward account consent flow. Tools cover projects, timers, spaces, share links, and webhook management.

Remote Worker

The public MCP transport runs as a Cloudflare Worker and uses OAuth 2.1 with PKCE through workers-oauth-provider.

MCP clients connect to the Worker URL:

https://mcp.example.com/mcp

During connection, the Worker redirects the user to the configured tickward app. The user signs in, approves the requested scopes, and tickward issues a scoped MCP connection credential through a one-time grant exchange.

Local Development

npm install
npm run dev

Useful checks:

curl http://localhost:8787/healthz
curl http://localhost:8787/.well-known/oauth-protected-resource

For local development against a self-hosted tickward app, copy .dev.vars.example to .dev.vars and point TICKWARD_APP_BASE_URL plus TICKWARD_API_BASE_URL at that app.

For the deployment sequence, use docs/cloudflare-deployment.md.

Development

npm run check

This runs the Node version guard, Biome, TypeScript, unit tests, and a Worker dry-run bundle.

Ver o original no GitHub

Bom para

Relacionados