### Run MCP Server

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/mcp-server.md

Execute this command to start the MCP server. Ensure you have bunx installed.

```bash
bunx @delorenj/mcp-server-trello
```

--------------------------------

### Install Project Dependencies

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

Install all necessary project dependencies using Bun. Ensure Bun is installed and configured correctly before running this command.

```bash
bun install
```

--------------------------------

### Preview Production Build

Source: https://github.com/konxc/kaede-powerup/blob/main/README.md

Starts a local server to preview the production build.

```bash
# Preview
bun run preview
```

--------------------------------

### Development Server

Source: https://github.com/konxc/kaede-powerup/blob/main/README.md

Starts a development server with CSS watching and hot-reloading.

```bash
# Development (CSS watch + static server)
bun run dev
```

--------------------------------

### Install Dependencies

Source: https://github.com/konxc/kaede-powerup/blob/main/README.md

Installs project dependencies using Bun.

```bash
# Install dependencies
bun install
```

--------------------------------

### Clone KAEDE MCP Repository

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

Clone the project repository and navigate into the project directory. This is the first step to start contributing.

```bash
git clone https://github.com/konxc/kaede-powerup.git
cd kaede-powerup
```

--------------------------------

### Setup Trello Credentials

Source: https://github.com/konxc/kaede-powerup/blob/main/README.md

Run this command to interactively set up your Trello API Key and Token. Alternatively, create a `secrets.env` file with your credentials.

```bash
# Interaktif — masukkan API Key & Token Trello
node scripts/kaede.mjs setup
```

```env
TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token
```

--------------------------------

### Copy .env.example to secrets.env

Source: https://github.com/konxc/kaede-powerup/blob/main/test/MANUAL-TESTING.md

Copies the example environment file to a new file for storing secrets. Use the appropriate command for your operating system.

```powershell
# Windows PowerShell
Copy-Item .env.example secrets.env
```

```bash
# Linux/Mac
cp .env.example secrets.env
```

--------------------------------

### Conventional Commit Message Example

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/playbook-template.md

An example of a conventional commit message demonstrating the structure with a type, scope, description, and body with bullet points.

```bash
feat(auth): implementasi login dengan Google SSO

- Tambah Google OAuth2 provider
- Buat callback handler
- Simpan refresh token ke database

Closes #42
```

--------------------------------

### Setup KAEDE MCP Credentials

Source: https://github.com/konxc/kaede-powerup/blob/main/test/TESTING-GUIDE.md

Run this command to set up your Trello API key and token for KAEDE MCP. Alternatively, manually edit the secrets.env file.

```bash
node scripts/kaede.mjs setup
```

```env
TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token
```

--------------------------------

### Add Wrapper Method

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

Example of adding a wrapper method in `src/trello-client.js` to call a new tool.

```javascript
async yourToolName(arg1, arg2) {
  return this.callTool('your_tool_name', { arg1, arg2 });
}

```

--------------------------------

### Add New Tool Definition

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

Example of adding a new tool definition to the `toolSchema` list in `src/mcp-server.js`. Specifies arguments and their types/descriptions.

```javascript
toolSchema('your_tool_name', 'Description of what it does', {
  arg1: { type: 'string', description: 'Description of arg1' },
  arg2: { type: 'number', description: 'Description of arg2' },
}, ['arg1']), // Required arguments

```

--------------------------------

### KAEDE CLI Development Commands

Source: https://github.com/konxc/kaede-powerup/blob/main/README.md

Development commands for the KAEDE CLI, including setup, viewing today's tasks, and checking status.

```bash
bun run kaede -- setup
```

```bash
bun run kaede -- today
```

```bash
bun run kaede -- status
```

--------------------------------

### Setup Global Credentials

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

Set up global credentials for the KAEDE MCP project using a Node.js script. This command creates a secrets.env file in a user-specific configuration directory, not within the project folder.

```bash
node scripts/kaede.mjs setup
```

--------------------------------

### Node.js Quick Start Test Script

Source: https://github.com/konxc/kaede-powerup/blob/main/test/MANUAL-TESTING.md

Executes a Node.js test script for attachments. Ensure the TEST_CARD_ID environment variable is set to a valid Trello Card ID.

```powershell
# Get Card ID from test board
# Card ID format: 67xxxxxxxxxxxxxxxxxxxxx (24 characters)

# Windows PowerShell
$env:TEST_CARD_ID="678f9a0b1c2d3e4f5a6b7c8d"; node test/manual-test-attachments.js

# Linux/Mac
TEST_CARD_ID="678f9a0b1c2d3e4f5a6b7c8d" node test/manual-test-attachments.js
```

--------------------------------

### Add New Tool Handler

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

Example of adding a new tool handler to `src/mcp-server.js`. Includes argument validation and Trello API call.

```javascript
case 'your_tool_name': {
  const { arg1, arg2 } = args;
  
  // Validation
  if (!arg1) {
    throw new Error('arg1 is required');
  }

  // Trello API call
  const response = await trelloPost(`/endpoint`, { arg1, arg2 });
  
  // Return structured result
  return {
    id: response.id,
    name: response.name,
    success: true,
  };
}

```

--------------------------------

### Helper Scripts for Testing

Source: https://github.com/konxc/kaede-powerup/blob/main/test/TESTING-GUIDE.md

These scripts assist in testing KAEDE MCP. Use the first to get card IDs from the test board and the second to run attachment tests.

```bash
# Get card IDs from test board
node test/get-test-card.js
```

```bash
# Run attachment tests
node test/manual-test-attachments.js
```

--------------------------------

### Test Board Setup Structure

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/FEATURE-SPECIFICATION.md

Defines the structure for test cards and lists used in setting up the Trello board for Kaede Power-Up testing. This includes specific card names for testing attachments, copying cards, checklists, and watch functionality.

```markdown
List: Test Attachments
  - Card: Test URL attachment
  - Card: Test local file attachment
  - Card: Test base64 attachment

List: Test Copy Card
  - Card: Source card (with labels, members, checklists)
  - Card: Copy destination

List: Test Checklists
  - Card: Test create/update/delete checklist
  - Card: Test checklist items

List: Test Watch
  - Card: Test watch/unwatch
```

--------------------------------

### Get All Lists on a Board

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to retrieve all lists associated with a specific board. Requires the board ID.

```json
{
  "name": "get_lists",
  "arguments": { "boardId": "board123" }
}
```

--------------------------------

### Get Board Labels Tool

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to retrieve all labels present on a specific board. Requires the board ID as an argument.

```json
{
  "name": "get_board_labels",
  "arguments": { "boardId": "board123" }
}
```

--------------------------------

### Get Card Activity History

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/mcp-server.md

Retrieve the history of activities for a Trello card.

```javascript
get_card_activity
```

--------------------------------

### Get Card Checklists

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/mcp-server.md

Retrieve all checklists associated with a Trello card. This is a new feature not present in the upstream TRELLO MCP.

```javascript
get_card_checklists
```

--------------------------------

### KAEDE Orchestrator MCP Tools

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/kaede-architecture.md

Tools for the KAEDE Orchestrator, focusing on context management without direct Trello access. Use `mcp.kaede.generate_plan` to get an action plan.

```javascript
mcp.kaede.parse_playbook(playbook)

mcp.kaede.bundle_context(playbook, openkb, opencode)

mcp.kaede.generate_plan(intent)

mcp.kaede.status(playbook_path, openkb_path)
```

--------------------------------

### Get Board Members Tool

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to retrieve all members associated with a specific board. Requires the board ID as an argument.

```json
{
  "name": "get_board_members",
  "arguments": { "boardId": "board123" }
}
```

--------------------------------

### Get Card Details

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to fetch comprehensive details for a specific card, including labels, members, due dates, and descriptions. The `includeMarkdown` argument controls whether descriptions are returned in markdown format.

```json
{
  "name": "get_card",
  "arguments": {
    "cardId": "FdhbArbK",
    "includeMarkdown": false
  }
}
```

--------------------------------

### Get Test Card IDs

Source: https://github.com/konxc/kaede-powerup/blob/main/test/README.md

This script retrieves all card IDs from the test board. The output can be used to set the TEST_CARD_ID environment variable for other tests.

```bash
node test/get-test-card.js
```

--------------------------------

### Build Project with npm

Source: https://github.com/konxc/kaede-powerup/blob/main/PR-SUBMISSION-SUMMARY.md

Compile and bundle the project using the npm run build command. This is a crucial step for quality assurance.

```bash
npm run build
```

--------------------------------

### Get Card Comments

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Retrieves all comments associated with a given card. You can specify a limit for the number of comments to fetch.

```json
{
  "name": "get_card_comments",
  "arguments": {
    "cardId": "card123",
    "limit": 100
  }
}
```

--------------------------------

### Initialize Kaede in Another Project

Source: https://github.com/konxc/kaede-powerup/blob/main/README.md

Run this command from within your target project to add Trello MCP configuration to `.opencode/opencode.json`.

```bash
# Dari dalam project target
node path/to/kaede/scripts/kaede.mjs init .
```

--------------------------------

### Get My Assigned Cards

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to retrieve all cards that are currently assigned to the logged-in user. No arguments are required.

```json
{ "name": "get_my_cards", "arguments": {} }
```

--------------------------------

### Contoh Konfigurasi .env untuk Kredensial Trello

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/api-key.md

Simpan kredensial API Key dan Token Trello Anda di file .env untuk menjaga kerahasiaannya. Pastikan untuk mengganti placeholder dengan nilai sebenarnya.

```dotenv
# Trello API credentials
TRELLO_API_KEY=your-api-key-here
TRELLO_TOKEN=your-token-here
```

--------------------------------

### Development Build Commands

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

Commands for building and previewing the project during development. Includes CSS watch, MCP server build, production CSS build, and preview.

```bash
# Development (CSS watch)
bun run dev

# Build MCP servers
bun run build:mcp

# Build production CSS
bun run build

# Preview
bun run preview

```

--------------------------------

### Project Structure Overview

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

This shows the directory layout of the kaede-powerup project, including source, distribution, test, documentation, scripts, and readme files.

```bash
kaede-powerup/
├── src/
│   ├── mcp-server.js          # Main MCP server
│   ├── trello-client.js       # Client wrapper
│   └── trello/
│       └── attachments.js     # Utility module
├── dist/
│   ├── mcp-server.js          # Compiled server
│   └── kaede-mcp-server.js    # Orchestrator
├── test/
│   ├── manual-test-*.js       # Test scripts
│   └── *-TESTING.md           # Test guides
├── docs/
│   └── DEVELOPMENT-ROADMAP.md
├── scripts/
│   └── kaede.mjs              # CLI tool
└── README.md

```

--------------------------------

### Build MCP Server

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

Build the MCP server using the 'build:mcp' script provided by Bun. This command compiles the necessary server files.

```bash
bun run build:mcp
```

--------------------------------

### Get Card Attachments

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/mcp-server.md

Retrieve all attachments associated with a specific Trello card. This is a new feature not present in the upstream TRELLO MCP.

```javascript
get_card_attachments
```

--------------------------------

### Check Configuration Status

Source: https://github.com/konxc/kaede-powerup/blob/main/README.md

Use this command to verify the status of your Kaede configuration.

```bash
node scripts/kaede.mjs status
```

--------------------------------

### Build Production CSS

Source: https://github.com/konxc/kaede-powerup/blob/main/README.md

Compiles CSS for production.

```bash
# Build production CSS
bun run build
```

--------------------------------

### Run Tests with npm

Source: https://github.com/konxc/kaede-powerup/blob/main/PR-SUBMISSION-SUMMARY.md

Execute all defined tests using the npm test command. Ensure this is run before building or submitting.

```bash
npm test
```

--------------------------------

### Get Cards by List ID

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to retrieve all cards within a specific list. Requires both the list ID and the board ID.

```json
{
  "name": "get_cards_by_list_id",
  "arguments": { "listId": "list123", "boardId": "board123" }
}
```

--------------------------------

### Verify MCP Server Build

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

Verify the size of the built MCP server file. The expected size is approximately 20 KB.

```bash
ls -lh dist/mcp-server.js
```

--------------------------------

### Konfigurasi Trello MCP di OpenCode

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/opencode.md

Edit file .opencode/opencode.json untuk menambahkan konfigurasi Trello MCP. Gunakan environment variable untuk credentials di production.

```json
{
  "mcp": {
    "trello": {
      "type": "local",
      "command": "bunx",
      "args": ["@delorenj/mcp-server-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      },
      "enabled": true
    }
  }
}
```

--------------------------------

### Get Attachments from Trello Card

Source: https://github.com/konxc/kaede-powerup/blob/main/test/TESTING-GUIDE.md

Retrieve all attachments associated with a given Trello card. The output will log the count and details (name, MIME type) of each attachment.

```javascript
const attachments = await client.getCardAttachments('CARD_ID');
console.log(`Found ${attachments.length} attachment(s)`);
attachments.forEach(att => {
  console.log(`- ${att.name} (${att.mimeType})`);
});
```

--------------------------------

### Expected Output for Successful Test Run

Source: https://github.com/konxc/kaede-powerup/blob/main/test/MANUAL-TESTING.md

This output shows a successful test run, including credential loading, connection status, and details of attached images and PDFs.

```text
  ╔╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╗
  ║    KAEDE — Manual Test Attachments   ║
  â•šâ• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• â• 

  ✓ Credentials loaded
  ✓ Test Card ID: 678f9a0b1c2d3e4f5a6b7c8d

  Test Board: https://trello.com/b/rAKmlRj3/lab-testing-kaede

  Connecting to MCP Server...
  ✓ Connected to MCP Server


  Test 1: Attach Image from URL
  ──────────────────────────────────────
  ✓ Image attached successfully
    ID: 678f9a0b1c2d3e4f5a6b7c8e
    Name: Test Image Attachment
    URL: https://trello.com/attachments/...
    MIME: image/png

  Test 2: Attach PDF from URL
  ──────────────────────────────────────
  ✓ PDF attached successfully
    ID: 678f9a0b1c2d3e4f5a6b7c8f
    Name: Test PDF Attachment
    URL: https://trello.com/attachments/...
    MIME: application/pdf

  Test 3: Get Card Attachments
  ──────────────────────────────────────
  ✓ Found 2 attachment(s)
    [1] Test Image Attachment
        Type: image/png
        Size: 12345 bytes
        URL: https://trello.com/attachments/...
    [2] Test PDF Attachment
        Type: application/pdf
        Size: 67890 bytes
        URL: https://trello.com/attachments/...

  ──────────────────────────────────────
  Tests completed: 3/3 passed
  ──────────────────────────────────────
```

--------------------------------

### Manual Testing Checklist for Each Tool

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/FEATURE-SPECIFICATION.md

Provides a checklist for manual testing of each Kaede Power-Up tool. It covers essential testing scenarios such as happy path, error handling, edge cases, rate limiting, and permission issues.

```markdown
- [ ] Happy path (normal usage)
- [ ] Error handling (invalid input)
- [ ] Edge cases (empty results, large datasets)
- [ ] Rate limiting (many rapid calls)
- [ ] Permission issues (read-only access)
```

--------------------------------

### Kaede Project Directory Structure

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/kaede-architecture.md

Overview of the project's directory layout, including configuration files, source code, documentation, and build artifacts.

```tree
powerup-konxc/
├── .github/workflows/docs.yml   # CI/CD auto-deploy dokumentasi Markdown → HTML
├── .opencode/
│   ├── opencode.json            # Konfigurasi AI Agent & MCP Server lokal
│   └── SHARED/
│       ├── agent-rules.md       # Aturan dasar perilaku AI Agent
│       └── project-context.md   # Konteks global project KAEDE
├── .openkb/
│   ├── TEMPLATE.md              # Template standar knowledge base
│   └── SHARED/
│       ├── decision-log.md      # Catatan keputusan arsitektur & fitur
│       ├── glossary.md          # 14 istilah kunci ekosistem KAEDE
│       └── references.md        # Tautan repositori & alat eksternal
├── dist/
│   └── mcp-server.js            # Kompilan Trello MCP Server (target: Bun)
├── docs/
│   ├── index.md                 # Ikhtisar dokumentasi
│   ├── api-key.md               # Panduan mendapatkan kredensial Trello
│   ├── mcp-server.md            # Konfigurasi Trello MCP Server
│   ├── opencode.md              # Dokumentasi integrasi Opencode
│   ├── tools.md                 # Deskripsi 24 tools Trello MCP yang tersedia
│   ├── role-management.md       # Detail integrasi role AI Agent & Trello
│   └── kaede-architecture.md    # [DOKUMEN INI] Arsitektur mendalam & roadmap
├── public/                      # Static Assets (Deploy Netlify)
│   ├── index.html               # Dual-Mode: Power-Up Connector & Landing Page
│   ├── board.html               # Dashboard Popup statis (Env stats)
│   ├── card.html                # Environment manager per kartu (PROD/STAG/DEV)
│   ├── auth.html                # Mock Authorization page
│   ├── privacy.html             # Kebijakan privasi multibahasa
│   └── js/kaede.js              # Implementasi 7 Capabilities Trello Power-Up
├── scripts/ 
│   ├── kaede.mjs                # CLI Tool utama (15+ commands: playbook, orchestrate, run, start, build, install, dll.)
│   └── build-docs.mjs           # Script kompilasi Markdown → HTML
└── src/
    ├── mcp-server.js            # Sumber kode Trello MCP Server (24 tools)
    ├── api-server.mjs           # HTTP API server (port 3456)
    ├── orchestrator.js          # Orchestrator — parsePlaybook, executeIntent, bundleContext, generatePlan
    ├── trello-client.js         # MCP Client — 24 tool wrappers + timeout + reconnect
    ├── style.css                # CSS Source (Tailwind v4 + custom utility)
    └── index.html               # Landing page (deployed to Netlify)

```

--------------------------------

### Create Label Tool

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to create a new label on a board. Requires the board ID, label name, and color.

```json
{
  "name": "create_label",
  "arguments": {
    "boardId": "board123",
    "name": "Bug",
    "color": "red"
  }
}
```

--------------------------------

### Get Current Card URL in Browser Console

Source: https://github.com/konxc/kaede-powerup/blob/main/test/MANUAL-TESTING.md

Execute these JavaScript commands in your browser's developer console while viewing a Trello card to retrieve its URL. The first command logs the entire URL, while the second attempts to extract a specific element containing the card ID.

```javascript
console.log(window.location.href);
```

```javascript
document.querySelector('[data-test-id="card-id"]')?.textContent
```

--------------------------------

### Run Manual Test Attachments

Source: https://github.com/konxc/kaede-powerup/blob/main/test/README.md

Execute manual tests for attachment tools. The TEST_CARD_ID environment variable must be set first.

```bash
# Windows PowerShell
$env:TEST_CARD_ID="67xxx..."; node test/manual-test-attachments.js
```

```bash
# Linux/Mac  
TEST_CARD_ID="67xxx..." node test/manual-test-attachments.js
```

--------------------------------

### View Today's Tasks

Source: https://github.com/konxc/kaede-powerup/blob/main/README.md

Execute this command to view your tasks for the current day.

```bash
node scripts/kaede.mjs today
```

--------------------------------

### Lint Project with npm

Source: https://github.com/konxc/kaede-powerup/blob/main/PR-SUBMISSION-SUMMARY.md

Check code style and potential errors using the npm run lint command. This helps maintain code quality.

```bash
npm run lint
```

--------------------------------

### Perintah Verifikasi Koneksi Trello

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/opencode.md

Gunakan perintah ini di OpenCode untuk memverifikasi koneksi Trello MCP setelah konfigurasi.

```text
Coba list semua board Trello yang saya punya.
```

--------------------------------

### Troubleshoot MCP Server Not Found

Source: https://github.com/konxc/kaede-powerup/blob/main/test/MANUAL-TESTING.md

If the MCP server is not found, rebuild the MCP server and verify its existence.

```powershell
# Rebuild MCP server
bun run build:mcp

# Verify file exists
Test-Path dist/mcp-server.js
```

--------------------------------

### Create Checklist

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to create a new checklist on a specific card. Requires a card ID and a name for the checklist.

```json
{
  "name": "create_checklist",
  "arguments": {
    "cardId": "card123",
    "name": "QA Checklist"
  }
}
```

--------------------------------

### create_label

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Creates a new label on a board with a specified name and color. Requires board ID, name, and color.

```APIDOC
## create_label

### Description
Creates a new label.

### Method
Not specified (assumed to be a tool call)

### Parameters
#### Arguments
- **boardId** (string) - Required - The ID of the board to create the label in.
- **name** (string) - Required - The name of the label.
- **color** (string) - Required - The color of the label.

### Request Example
```json
{
  "name": "create_label",
  "arguments": {
    "boardId": "board123",
    "name": "Bug",
    "color": "red"
  }
}
```

### Response
(Response structure not specified in source)
```

--------------------------------

### create_checklist

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Creates a new checklist on a card. Requires a card ID and a name for the checklist.

```APIDOC
## create_checklist

### Description
Creates a new checklist on a card.

### Method
Not specified (assumed to be a tool call)

### Endpoint
Not specified

### Parameters
#### Arguments
- **cardId** (string) - Required - The ID of the card to which the checklist will be added.
- **name** (string) - Required - The name of the new checklist.

### Request Example
```json
{
  "name": "create_checklist",
  "arguments": {
    "cardId": "card123",
    "name": "QA Checklist"
  }
}
```

### Response
Success response structure not specified.
```

--------------------------------

### Contoh Percakapan AI dengan Trello

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/opencode.md

Contoh interaksi antara pengguna dan AI Agent setelah integrasi Trello MCP berhasil.

```text
"Apa task yang sedang dalam status 'In Progress' di board project saya?"
```

```text
"Ada 3 kartu di list 'In Progress': 'Fix login bug' (dimulai 24 Juni), 'Update dashboard' (due 28 Juni), 'Integrasi API payment' (due 30 Juni)."
```

```text
"Buat kartu baru 'Setup CI/CD pipeline' di list 'To Do' dengan label development."
```

```text
"Kartu 'Setup CI/CD pipeline' sudah dibuat di list 'To Do' dengan label development."
```

--------------------------------

### Perintah Mengatur Board Aktif Trello

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/opencode.md

Perintah untuk mengatur board Trello yang aktif untuk sesi OpenCode.

```text
Set active board saya ke board "Sprint 24".
```

```text
Gunakan tool set_active_board dengan boardId "abc123xyz".
```

--------------------------------

### Run Direct MCP Server Test

Source: https://github.com/konxc/kaede-powerup/blob/main/test/MANUAL-TESTING.md

Command to execute the direct MCP server testing script using Node.js.

```powershell
node test/test-direct.js
```

--------------------------------

### Add New List to Board

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to create a new list on a specified board. Requires the board ID and the desired name for the new list.

```json
{
  "name": "add_list_to_board",
  "arguments": {
    "boardId": "board123",
    "name": "Sprint 25"
  }
}
```

--------------------------------

### Automated Test Scripts List

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/FEATURE-SPECIFICATION.md

Lists the automated test script files for the Kaede Power-Up. These scripts cover various functionalities including attachments, card copying, checklist enhancements, and advanced features.

```bash
test/attachments.test.js
test/copy-card.test.js
test/checklist-enhancements.test.js
test/advanced-features.test.js
```

--------------------------------

### Export Credentials to Session

Source: https://github.com/konxc/kaede-powerup/blob/main/README.md

Commands to export Trello credentials to your current session. Use `iex` for PowerShell and `eval` for Bash.

```powershell
# Export credentials ke session (PowerShell)
node scripts/kaede.mjs env | iex
```

```bash
# Export credentials ke session (Bash)
eval $(node scripts/kaede.mjs env)
```

--------------------------------

### Create Feature Branch

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

Command to create a new branch for feature development from the main branch.

```bash
git checkout -b feature/my-feature

```

--------------------------------

### Sprint Workflow Stages

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/playbook-template.md

Visual representation of the Trello card flow through different sprint stages. Ensure cards meet 'Definition of Ready' before development begins and 'Definition of Done' upon completion.

```text
Product Backlog → Ready for Dev → In Progress → Code Review → UAT/Testing → Done
```

--------------------------------

### Troubleshoot Unauthorized Error

Source: https://github.com/konxc/kaede-powerup/blob/main/test/MANUAL-TESTING.md

For 'Unauthorized' errors, regenerate the token, update secrets, and restart the server.

```text
- Regenerate token di https://trello.com/app-key
- Update `secrets.env`
- Restart MCP server
```

--------------------------------

### Register get_card_checklists Tool

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/CONTRIBUTION-GUIDE.md

Registers a new tool for retrieving card checklists, including items and completion percentage. It accepts a cardId and manages errors.

```typescript
this.server.registerTool(
  'get_card_checklists',
  {
    title: 'Get Card Checklists',
    description: 'Get all checklists from a card with items and completion percentage',
    inputSchema: {
      cardId: z.string().describe('ID of the card'),
    },
  },
  async ({ cardId }) => {
    try {
      const checklists = await this.trelloClient.getCardChecklists(cardId);
      return {
        content: [{ type: 'text' as const, text: JSON.stringify(checklists, null, 2) }],
      };
    } catch (error) {
      return this.handleError(error);
    }
  }
);
```

--------------------------------

### Add Card to List

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to create a new card within a specified list. Supports setting the card name, description, due date, and labels.

```json
{
  "name": "add_card_to_list",
  "arguments": {
    "listId": "list123",
    "name": "Setup CI/CD",
    "description": "Implement pipeline",
    "dueDate": "2026-07-01T12:00:00Z",
    "labels": ["label-id-1"]
  }
}
```

--------------------------------

### Conventional Commits Structure

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/playbook-template.md

Use this format for commit messages to standardize commit history. Include a type, optional scope, a concise description, and an optional body and footer for more details.

```bash
<type>(<scope>): <description>

[optional body]

[optional footer]
```

--------------------------------

### Contoh Judul Card Trello

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/playbook-template.md

Gunakan format `<tipe>: <deskripsi singkat>` untuk judul card. Tipe yang umum digunakan meliputi feat, fix, docs, refactor, test, chore, dan perf.

```markdown
feat: Tambah halaman login SSO
```

```markdown
fix: Perbaiki validasi email duplikat
```

```markdown
docs: Update API documentation
```

```markdown
refactor: Pisahkan UserController jadi service layer
```

```markdown
test: Tambah unit test untuk AttendanceService
```

```markdown
chore: Upgrade dependency Laravel 10→11
```

```markdown
perf: Optimasi query presensi harian
```

--------------------------------

### Template Deskripsi Card Trello

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/playbook-template.md

Template ini menyediakan struktur untuk mendeskripsikan masalah, user story, acceptance criteria, technical notes, dan environment.

```markdown
## Deskripsi
[Apa masalahnya? Apa yang ingin dicapai?]

## User Story
Sebagai [Peran], saya ingin [Tindakan], sehingga [Manfaat].

## Acceptance Criteria
- [ ] Kriteria 1
- [ ] Kriteria 2
- [ ] Kriteria 3

## Technical Notes
- Stack: [Laravel / React / dll]
- Database: [tabel yang terpengaruh]
- Migration: [file migration baru?]

## Environment
- Target: [PROD / STAG / DEV]
- Deploy URL: [opsional]
```

--------------------------------

### Rebuild MCP Server

Source: https://github.com/konxc/kaede-powerup/blob/main/CONTRIBUTING.md

Command to rebuild the MCP server after adding new tools or making changes.

```bash
bun run build:mcp

```

--------------------------------

### Test Results Template

Source: https://github.com/konxc/kaede-powerup/blob/main/test/README.md

A markdown template for documenting test results. Includes sections for session details, phase-specific results, issues found, and a summary.

```markdown
## Test Session: YYYY-MM-DD

**Tester:** [Nama]
**Test Board:** https://trello.com/b/rAKmlRj3/lab-testing-kaede

### Phase 1: Attachments

| Tool | Status | Notes |
|------|--------|-------|
| attach_file_to_card | ✅ Pass | [Notes] |

### Issues Found

1. [Issue description]

### Summary

- **Total Tests:** 20
- **Passed:** 18
- **Failed:** 2
```

--------------------------------

### Direct MCP Server Testing with Node.js

Source: https://github.com/konxc/kaede-powerup/blob/main/test/MANUAL-TESTING.md

Tests Trello MCP client functionalities directly, including attaching an image and retrieving attachments. Replace 'CARD_ID' with a valid Trello Card ID.

```javascript
import { TrelloMCPClient } from '../src/trello-client.js';

const client = new TrelloMCPClient();

async function test() {
  await client.connect();
  
  // Test 1: Attach image
  const result = await client.attachImageToCard(
    'CARD_ID',
    'https://via.placeholder.com/400x300.png',
    'Test Image'
  );
  console.log('Attached:', result);
  
  // Test 2: Get attachments
  const attachments = await client.getCardAttachments('CARD_ID');
  console.log('Attachments:', attachments);
  
  client.close();
}

test();
```

--------------------------------

### Archive a List

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to archive an existing list. Requires the list ID of the list to be archived.

```json
{
  "name": "archive_list",
  "arguments": { "listId": "list123" }
}
```

--------------------------------

### Assign Member to Card Tool

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Use this tool to add a member to a specific card. Requires both the card ID and the member ID.

```json
{
  "name": "assign_member_to_card",
  "arguments": {
    "cardId": "card123",
    "memberId": "member456"
  }
}
```

--------------------------------

### get_lists

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Retrieves all lists associated with a specific board. Requires the board ID as an argument.

```APIDOC
## get_lists

### Description
Mendapatkan semua list di sebuah board.

### Method
Not specified (Tool call)

### Arguments
- **boardId** (string) - Required - The ID of the board.

### Request Example
```json
{
  "name": "get_lists",
  "arguments": {
    "boardId": "board123"
  }
}
```

### Response
(Response details not specified in source)
```

--------------------------------

### add_card_to_list

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Creates a new card within a specified list. Supports setting name, description, due date, and labels.

```APIDOC
## add_card_to_list

### Description
Membuat kartu baru di list tertentu.

### Method
Not specified (Tool call)

### Arguments
- **listId** (string) - Required - The ID of the list to add the card to.
- **name** (string) - Required - The name of the new card.
- **description** (string) - Optional - The description for the new card.
- **dueDate** (string) - Optional - The due date for the card in ISO 8601 format.
- **labels** (array of strings) - Optional - An array of label IDs to assign to the card.

### Request Example
```json
{
  "name": "add_card_to_list",
  "arguments": {
    "listId": "list123",
    "name": "Setup CI/CD",
    "description": "Implement pipeline",
    "dueDate": "2026-07-01T12:00:00Z",
    "labels": ["label-id-1"]
  }
}
```

### Response
(Response details not specified in source)
```

--------------------------------

### Retrieve Cards by List ID using TrelloMCPClient

Source: https://github.com/konxc/kaede-powerup/blob/main/test/MANUAL-TESTING.md

This JavaScript code snippet uses the TrelloMCPClient to connect to Trello, fetch all cards within a specified list, and log their IDs and names to the console. Ensure you have authenticated and replaced 'LIST_ID' with the correct list identifier.

```javascript
import { TrelloMCPClient } from '../src/trello-client.js';

const client = new TrelloMCPClient();
await client.connect();

const cards = await client.getCardsByListId('LIST_ID');
cards.forEach(card => {
  console.log(`${card.id} - ${card.name}`);
});

client.close();
```

--------------------------------

### get_card

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/tools.md

Retrieves detailed information for a specific card, including labels, members, due date, and description. Requires card ID and an option to include markdown.

```APIDOC
## get_card

### Description
Mendapatkan detail lengkap kartu — label, member, due date, deskripsi.

### Method
Not specified (Tool call)

### Arguments
- **cardId** (string) - Required - The ID of the card.
- **includeMarkdown** (boolean) - Optional - Whether to include markdown in the response.

### Request Example
```json
{
  "name": "get_card",
  "arguments": {
    "cardId": "FdhbArbK",
    "includeMarkdown": false
  }
}
```

### Response
(Response details not specified in source)
```

--------------------------------

### Register get_card_attachments Tool

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/CONTRIBUTION-GUIDE.md

Registers a new tool for retrieving card attachments. It takes a cardId and an optional limit, handling potential errors.

```typescript
this.server.registerTool(
  'get_card_attachments',
  {
    title: 'Get Card Attachments',
    description: 'Retrieve all attachments from a specific card',
    inputSchema: {
      cardId: z.string().describe('ID of the card'),
      limit: z.number().optional().default(100).describe('Max attachments'),
    },
  },
  async ({ cardId, limit }) => {
    try {
      const attachments = await this.trelloClient.getCardAttachments(cardId, limit);
      return {
        content: [{ type: 'text' as const, text: JSON.stringify(attachments, null, 2) }],
      };
    } catch (error) {
      return this.handleError(error);
    }
  }
);
```

--------------------------------

### Set Active Board

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/mcp-server.md

Dynamically change the active Trello board without restarting the server.

```javascript
set_active_board
```

--------------------------------

### Search Labels by Name

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/mcp-server.md

Filter Trello labels based on their names.

```javascript
search_labels
```

--------------------------------

### Test get_card_attachments Functionality

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/CONTRIBUTION-GUIDE.md

Tests the get_card_attachments tool, verifying it returns an array of attachments and respects the limit parameter.

```typescript
describe('get_card_attachments', () => {
  it('should return array of attachments', async () => {
    const attachments = await client.getCardAttachments('card123');
    expect(Array.isArray(attachments)).toBe(true);
    expect(attachments[0]).toHaveProperty('id');
    expect(attachments[0]).toHaveProperty('url');
  });

  it('should respect limit parameter', async () => {
    const attachments = await client.getCardAttachments('card123', 5);
    expect(attachments.length).toBeLessThanOrEqual(5);
  });
});
```

--------------------------------

### Watch List Activity

Source: https://github.com/konxc/kaede-powerup/blob/main/docs/mcp-server.md

Subscribe to receive notifications for activity within a specific Trello list.

```javascript
watch_list
```