English Français العربية

com.ithura/mcp

السجل الرسمي الإنتاجية

Manage tasks, sprints, projects, and wiki pages in your Ithura workspace.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package ithura-mcp
Claude Code 
claude mcp add com-ithura-mcp -e 'ITHURA_API_KEY=<your ithura_api_key>' -e 'ITHURA_WORKSPACE_SLUG=<ITHURA_WORKSPACE_SLUG>' -e 'ITHURA_API_URL=https://api.ithura.com' -- npx -y ithura-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "com-ithura-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "ithura-mcp@1.0.1"
            ],
            "env": {
                "ITHURA_API_KEY": "<your ithura_api_key>",
                "ITHURA_WORKSPACE_SLUG": "<ITHURA_WORKSPACE_SLUG>",
                "ITHURA_API_URL": "https://api.ithura.com"
            }
        }
    }
}

متغيرات البيئة

  • ITHURA_API_KEY إلزامي سري Workspace API token, created under Settings > API tokens. Carries the permissions of the member who created it.
  • ITHURA_WORKSPACE_SLUG إلزامي The workspace slug, as it appears in your Ithura URL.
  • ITHURA_API_URL API base URL. Defaults to https://api.ithura.com; set this when self-hosting.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Ithura MCP server
  2. Install
  3. Configuration
  4. Tools
  5. Notes
  6. Links
  7. License

Ithura MCP server

A Model Context Protocol server for Ithura, a quiet project management workspace for deliberate teams.

Point Claude, Cursor, or any MCP client at your Ithura workspace and let it read and write real work: tasks, sprints, projects, modules, wiki pages, and intake.

"What is left in the current sprint?"
"Create a task for the login timeout bug and put it in this sprint."
"Summarise every task that moved to Done this week."

Listed in the official MCP Registry as com.ithura/mcp.

Install

No install step. Point your MCP client at npx:

npx ithura-mcp
Claude Desktop / Claude Code

Add to your MCP settings (claude_desktop_config.json, or .mcp.json in a project for Claude Code):

{
  "mcpServers": {
    "ithura": {
      "command": "npx",
      "args": ["-y", "ithura-mcp"],
      "env": {
        "ITHURA_API_KEY": "your-api-token",
        "ITHURA_WORKSPACE_SLUG": "your-workspace"
      }
    }
  }
}
Cursor

~/.cursor/mcp.json takes the same block.

Configuration

VariableRequiredDefaultNotes
ITHURA_API_KEYyesWorkspace API token, from Settings > API tokens
ITHURA_WORKSPACE_SLUGyesThe slug in your workspace URL
ITHURA_API_URLnohttps://api.ithura.comPoint at your own host when self-hosting

Create the token in Ithura under Settings > API tokens. It carries the permissions of the member who created it, so create it as a user whose access matches what you want the agent to have.

Tools

23 tools across the work graph:

AreaTools
Projectslist_projects, get_project, create_project, update_project
Taskslist_issues, get_issue, create_issue, update_issue, delete_issue
Commentslist_issue_comments, add_issue_comment
Sprintslist_cycles, create_cycle, add_issues_to_cycle, remove_issue_from_cycle
Moduleslist_modules, create_module, add_issues_to_module, delete_module
Metadatalist_states, list_labels, create_label
Searchsearch_workspace

Every tool returns JSON, so the model sees real field values rather than prose.

Notes

  • The API noun for a work item is issue in the HTTP API; the product calls them tasks. The tool names follow the API.
  • Writes are real. Consider a token scoped to a member with limited project access if you want the agent kept to a corner of the workspace.
  • Self-hosting: set ITHURA_API_URL to your instance and everything else works unchanged.

License

MIT

الأسئلة الشائعة

ما هو com.ithura/mcp؟

Manage tasks, sprints, projects, and wiki pages in your Ithura workspace.

كيف أثبّت com.ithura/mcp؟

يعمل على جهازك. في Claude Code: claude mcp add com-ithura-mcp -e 'ITHURA_API_KEY=<your ithura_api_key>' -e 'ITHURA_WORKSPACE_SLUG=<ITHURA_WORKSPACE_SLUG>' -e 'ITHURA_API_URL=https://api.ithura.com' -- npx -y ithura-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج com.ithura/mcp إلى مفتاح API؟

نعم. يتطلب ITHURA_API_KEY, ITHURA_WORKSPACE_SLUG، وتضبطها في إعداداته.

هل com.ithura/mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون com.ithura/mcp؟

ينشره Ithura. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.