Manual

Claude Integration adds an extension to the Claude desktop app (Windows, macOS) so you can work in GeckoFlag by chatting with Claude. You can search, view, create and update issues, projects, wiki pages and notes, and export Gantt charts to Excel. The extension runs on the user’s computer and communicates directly with the user’s GeckoFlag only. Every action runs with the user permissions of the API token’s owner.

Administrator Settings

1. 1Open Settings in the sidebar and click Edit on the Claude Integration card.
2. 2Turn on Enable Claude integration (off by default). If Claude should also create and change data, turn on Allow writing as well, then save. If writing is not allowed, all tokens are read-only.
3. 3In Users, open Edit for the user, turn on Allow Claude integration (API) and click Update. This is separate from “Allow AI-assisted registration”. Removing the permission deletes all of that user’s API tokens.

Creating an API Token

1. 1Open Profile in the sidebar and, in the API Tokens section, set the token name, the expiry (30, 90 or 365 days, or never; the default is 90 days) and the permission (Read only or Read and write), then create the token.
2. 2Copy the token shown (a string starting with gfk_). The token is shown only once, right after it is created. Also note the “URL to enter in the extension” shown in the same section.

• Each person can create up to 5 tokens, and can delete tokens they no longer use from their profile at any time.
• When a token is created, its owner receives a notification email. Changing your password deletes all of your tokens.

Setting Up the Claude Desktop App

1. 1In the Claude desktop app, open Settings → Extensions, drag and drop the GeckoFlag extension file (.mcpb) and click Install. You can also install it by double-clicking the file or from Advanced settings. The extension file is included in the download you get after purchasing GeckoFlag.
2. 2On the settings screen, fill in the following fields and click Save.
   • GeckoFlag URL (required): The URL you noted. https:// is required (http:// works only for localhost, *.test and *.local).
   • API token (required): The token you copied. It is saved masked.
   • Export folder (optional): Where Gantt chart Excel files are saved. If left empty, they are saved to your Downloads folder.
   
3. 3Ask Claude to “Check that you can connect to GeckoFlag”. Setup is complete when it shows the token owner, the GeckoFlag version and whether writing is possible.

For detailed steps with screenshots, see the Claude Integration setup guide. We recommend setting write actions to “Ask every time” in the Claude extension settings.

What You Can Do

• Issues: Search (by project, status, assignee, reporter, priority, keyword, due date or parent issue), view details and comments, create (including a parent issue and who to notify), change fields, post comments and change the status.
• Projects: View the list and details, create (everyone except guests), change the name, description, owner and period, mark as completed or not completed, and add or remove members (owners and administrators).
• Wiki: View, rewrite the title and body, and add to the end (project members and administrators).
• Notes: List, search, view, create, rewrite and add to your own notes.
• Master data: Add issue types, statuses, priorities and job titles (departments), and change their names and colors (administrators).
• Gantt chart: Save a project’s issues (up to 5,000) to your computer as an Excel file. If the period is longer than 120 days, each column becomes one week.
• User search: Find users by name (ID and role only; email addresses are not returned).

Issues can be specified by key, such as “WEB-12”. Writing requires both a “Read and write” token and “Allow writing” for the site.