Projektbezogene Eingrenzung

Der MCP-Server von Almirant unterstützt einen optionalen Parameter projectId in der Verbindungs-URL, der Vorgänge automatisch auf das angegebene Projekt beschränkt. Das ist besonders hilfreich, wenn ein KI-Agent im Kontext eines einzelnen Projekts arbeitet.

Funktionsweise

Wenn projectId in der Verbindungs-URL konfiguriert ist:

• list_projects gibt nur das konfigurierte Projekt zurück
• list_work_items filtert automatisch nach dem Projekt
• create_work_item verwendet das Projekt als Standardwert
• create_task, create_story, create_feature, create_epic erfordern, dass projectId in der Sitzung konfiguriert ist
• list_idea_items filtert automatisch nach dem Projekt
• list_milestones filtert automatisch nach dem Projekt
• get_board_context gibt Boards des konfigurierten Projekts zurück

Ohne projectId arbeiten die Tools über alle Projekte der Organisation hinweg.

Konfiguration

Füge den Parameter projectId als Query-String zur URL hinzu:

{
  "mcpServers": {
    "almirant": {
      "type": "http",
      "url": "https://api.almirant.ai/mcp?projectId=<tu-project-uuid>",
      "headers": {
        "Authorization": "Bearer <tu-api-key>"
      }
    }
  }
}

Project ID ermitteln

Es gibt zwei Möglichkeiten, deine Project ID zu finden:

Über die Almirant-Oberfläche

1. Navigiere in Almirant zum gewünschten Projekt
2. Die UUID wird in der Browser-URL angezeigt: https://app.almirant.ai/projects/<project-uuid>/...

Über MCP ohne Eingrenzung

Führe das Tool list_projects ohne konfiguriertes projectId aus, um die vollständige Liste der Projekte mit ihren IDs abzurufen:

{
  "tool": "list_projects"
}

Die Antwort enthält die id jedes Projekts:

{
  "projects": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Mi Proyecto"
    }
  ]
}

Überschreibung per Parameter

Tools, die einen expliziten Parameter projectId akzeptieren, haben immer Vorrang vor dem in der Sitzung konfigurierten Wert. Dadurch kannst du einzelne Vorgänge für ein anderes Projekt ausführen, ohne die Konfiguration zu ändern:

{
  "tool": "list_work_items",
  "params": {
    "projectId": "otro-project-uuid"
  }
}

Von der Eingrenzung betroffene Tools

Tool	Verhalten mit projectId
list_projects	Gibt nur das konfigurierte Projekt zurück
list_work_items	Filtert automatisch nach Projekt
create_work_item	Verwendet das Projekt als Standardwert, wenn kein projectId übergeben wird
create_task	Erfordert projectId in der Sitzung (akzeptiert keinen Parameter)
create_story	Erfordert projectId in der Sitzung (akzeptiert keinen Parameter)
create_feature	Erfordert projectId in der Sitzung (akzeptiert keinen Parameter)
create_epic	Erfordert projectId in der Sitzung (akzeptiert keinen Parameter)
get_board_context	Gibt Boards des konfigurierten Projekts zurück
get_project_roadmap	Verwendet das konfigurierte Projekt als Fallback
list_idea_items	Filtert automatisch nach Projekt
list_milestones	Verwendet das konfigurierte Projekt als Fallback
create_milestone	Verwendet das konfigurierte Projekt als Fallback
get_implement_context	Verwendet das konfigurierte Projekt als Fallback
get_ideation_context	Verwendet das konfigurierte Projekt als Fallback
get_validate_context	Verwendet das konfigurierte Projekt als Fallback
resolve_work_items	Filtert Ergebnisse nach Projekt, wenn es konfiguriert ist

Empfehlung

Für Arbeitsabläufe mit KI-Agenten wird empfohlen, projectId immer in der Verbindungs-URL zu konfigurieren. Das vermeidet Fehler durch fehlenden Kontext und stellt sicher, dass alle Vorgänge für das richtige Projekt ausgeführt werden.