Model Context Protocol

Hubungkan AI Agentke workspace Tenanan.

MCP memungkinkan AI agent seperti Claude, ChatGPT, Cursor mengelola task, time tracking, dan project langsung dari percakapan.

OAuth + API TokenClaude, ChatGPT, Cursor26 Tools

Mulai di Sini

Quick Start

OAuth = login via browser (recommended). API Token = buat token manual.

Login via Browser (OAuth)

Recommended

Tidak perlu buat token manual

Tambahkan config ke AI Agent

Copy config di bawah. Paste ke file konfigurasi MCP di AI agent Anda.

config.json

{
  "mcpServers": {
    "tenanan": {
      "url": "https://tenanan.com/api/mcp"
    }
  }
}

Login di browser

Saat pertama kali connect, AI agent buka browser ke halaman login Tenanan. Login, lalu klik "Izinkan Akses".

Selesai! Mulai gunakan

Token otomatis dibuat. Buka AI agent dan mulai kelola workspace.

Contoh:

"List semua task yang statusnya todo"

API Token (Manual)

Untuk automated workflows atau CI/CD

Buat API Token

Simpan token dengan baik — hanya ditampilkan sekali.

Copy konfigurasi

Scroll ke bawah, pilih platform Anda. Ganti tn_xxx dengan token.

Siap digunakan

Buka AI agent dan mulai kelola workspace Tenanan.

Konfigurasi

Setup per AI Agent

Klik platform Anda untuk展开 config. Setiap config ada OAuth dan API Token.

File konfigurasi:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

OAuth (Recommended)

claude_desktop_config.json

{
  "mcpServers": {
    "tenanan": {
      "url": "https://tenanan.com/api/mcp"
    }
  }
}

Atau gunakan API Token:

claude_desktop_config.json

{
  "mcpServers": {
    "tenanan": {
      "command": "npx",
      "args": ["-y", "tsx", "https://tenanan.com/mcp/index.ts"],
      "env": {
        "TENANAN_MCP_TOKEN": "tn_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

OAuth (Recommended)

terminal

claude mcp add tenanan --transport http https://tenanan.com/api/mcp

Atau gunakan API Token:

terminal

claude mcp add tenanan -e TENANAN_MCP_TOKEN=tn_xxx -- npx -y tsx https://tenanan.com/mcp/index.ts

Settings > Developer > MCP Servers

OAuth (Recommended)

config.json

{
  "mcpServers": {
    "tenanan": {
      "url": "https://tenanan.com/api/mcp"
    }
  }
}

Atau gunakan API Token:

config.json

{
  "mcpServers": {
    "tenanan": {
      "command": "npx",
      "args": ["-y", "tsx", "https://tenanan.com/mcp/index.ts"],
      "env": {
        "TENANAN_MCP_TOKEN": "tn_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

File konfigurasi:

.cursor/mcp.json

OAuth (Recommended)

.cursor/mcp.json

{
  "mcpServers": {
    "tenanan": {
      "url": "https://tenanan.com/api/mcp"
    }
  }
}

Atau gunakan API Token:

.cursor/mcp.json

{
  "mcpServers": {
    "tenanan": {
      "command": "npx",
      "args": ["-y", "tsx", "https://tenanan.com/mcp/index.ts"],
      "env": {
        "TENANAN_MCP_TOKEN": "tn_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

File konfigurasi:

.vscode/mcp.json

OAuth (Recommended)

.vscode/mcp.json

{ "servers": { "tenanan": { "type": "http", "url": "https://tenanan.com/api/mcp" } } }

Atau gunakan API Token:

.vscode/mcp.json

{
  "servers": {
    "tenanan": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tsx", "https://tenanan.com/mcp/index.ts"],
      "env": {
        "TENANAN_MCP_TOKEN": "tn_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Settings > MCP

OAuth (Recommended)

config.json

{
  "mcpServers": {
    "tenanan": {
      "url": "https://tenanan.com/api/mcp"
    }
  }
}

Atau gunakan API Token:

config.json

{
  "mcpServers": {
    "tenanan": {
      "command": "npx",
      "args": ["-y", "tsx", "https://tenanan.com/mcp/index.ts"],
      "env": {
        "TENANAN_MCP_TOKEN": "tn_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Hermes, Cline, Aider, atau MCP-compatible lainnya

OAuth (Recommended)

config.json

{
  "mcpServers": {
    "tenanan": {
      "url": "https://tenanan.com/api/mcp"
    }
  }
}

Atau gunakan API Token:

config.json

{
  "mcpServers": {
    "tenanan": {
      "command": "npx",
      "args": ["-y", "tsx", "https://tenanan.com/mcp/index.ts"],
      "env": {
        "TENANAN_MCP_TOKEN": "tn_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Referensi

MCP Tools

26 tools siap digunakan dari AI agent.

list_tasks	List task dengan filter (project, status, priority, search)
get_task	Detail task lengkap dengan subtasks dan comments
create_task	Buat task baru dengan title, project, priority, due date
update_task	Update field task (status, assignee, due date, dll)
delete_task	Hapus task secara permanen
list_subtasks	List semua subtask dari sebuah task
create_subtask	Tambah subtask baru
toggle_subtask	Tandai subtask done/undone
list_task_audit_logs	Riwayat perubahan task

get_running_timer	Cek timer yang sedang berjalan
start_timer	Mulai timer untuk task atau project
stop_timer	Hentikan timer yang sedang berjalan
log_manual_time	Input manual time entry
list_time_entries	Riwayat time entries dengan filter tanggal

list_projects	List semua project di workspace
get_project	Detail project
create_project	Buat project baru
get_project_stats	Statistik project (task counts, progress)

list_task_comments	List komentar/chat di task
post_task_comment	Kirim komentar di task
list_notifications	List notifikasi terbaru
get_unread_count	Jumlah notifikasi belum dibaca

list_todos	List todo personal
create_todo	Buat todo baru
toggle_todo	Tandai todo done/undone
delete_todo	Hapus todo

Developer

HTTP API

Akses MCP Server via HTTP POST. Untuk integrasi custom atau testing.

List tools

curl -X POST https://tenanan.com/api/mcp \
  -H "Authorization: Bearer tn_xxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Call tool

curl -X POST https://tenanan.com/api/mcp \
  -H "Authorization: Bearer tn_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "list_tasks",
      "arguments": { "status": "todo", "limit": 5 }
    },
    "id": 2
  }'

Endpoints

POST/api/mcp—MCP JSON-RPC

GET/api/mcp—Server info

GET/.well-known/oauth-authorization-server—OAuth metadata

POST/api/mcp/auth/register—Client registration

GET/api/mcp/auth/authorize—OAuth authorization

POST/api/mcp/auth/token—Token exchange (PKCE)

POST/api/mcp/tokens—Buat API token

GET/api/mcp/tokens—List API tokens

DELETE/api/mcp/tokens—Revoke API token

Keamanan

Token Hashing

SHA-256 sebelum disimpan. Plaintext tidak pernah di database.

One-time Display

Token hanya ditampilkan sekali. Hilang = buat baru.

Scope Control

read/write/admin. Batasi akses sesuai kebutuhan.

Auto Expire

OAuth 1 jam. API token bisa diatur expired atau di-revoke.

FAQ

Pertanyaan Umum

Model Context Protocol — standar yang memungkinkan AI agent terhubung ke tools eksternal. Dengan MCP, AI bisa langsung mengelola task, project, dan time tracking di Tenanan.

OAuth = login via browser, mudah, session 1 jam. API Token = buat manual, cocok untuk CI/CD atau automated workflows. Keduanya bisa digunakan.

Buat baru di Settings > Account > API Tokens. Token lama bisa di-revoke dulu.

Cek koneksi internet. Pastikan token belum expired (API Token) atau sudah login (OAuth). Restart AI agent setelah ubah config.

Ya! Login akun yang sama. OAuth perlu login ulang setelah 1 jam. API Token bisa dipakai di mana saja selama valid.

Settings > Account > API Tokens > klik trash. Untuk OAuth, logout dari Tenanan.