First-party app
Jira Data Center

Jira Data Center

Create, search and transition issues on a self-hosted Jira Data Center or Jira Server instance.

stable Project ManagementDeveloper Tools

About

Jira Data Center ships in the w6w first-party pack. It declares 15 actions, 3 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.jira-data-center
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Project Management · Developer Tools

Overview

Jira Data Center is Atlassian’s self-hosted, clustered deployment of Jira — a genuinely different product from Jira Cloud (the sibling jira app in this pack), reachable at whatever domain a customer’s IT team gave it rather than a fixed *.atlassian.net host. This app treats that instance address the way it treats any self-hosted app’s URL — a connection field, not something a manifest can allowlist.

It covers the same day-to-day loop as the Cloud app — creating, searching, updating, transitioning and deleting issues; adding, listing and deleting comments; listing and reading projects; looking up and searching users — adapted to the classic v2 REST API Data Center actually serves: plain wiki-markup strings instead of Atlassian Document Format for descriptions and comment bodies, and usernames instead of Jira Cloud’s opaque account ids for assigning issues and identifying people.

Authentication is a Personal Access Token sent as a bearer credential — Atlassian’s own recommended method alongside OAuth 2.0, which this version skips because it requires registering an application link inside each target instance’s admin console before a single Connection can be made. A username/password Basic method is included as a fallback for instances where PAT creation is disabled. Boards and sprints (the separate agile API), attachments, issue links, worklogs and every admin-only surface are out of scope for a first version.

Build with Jira Data Center

Three routes to the same 15 actions. The Workflow tab is generated from Jira Data Center's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Add Comment

comment-add

Post a comment on an issue, optionally restricted to one role.

Delete Comment

comment-delete

Delete a comment from an issue.

List Comments

comment-get-many

List the comments on an issue.

Assign Issue

issue-assign

Assign an issue to a user, or leave the username empty to unassign it.

Create Issue

issue-create

Create an issue in a project.

Delete Issue

issue-delete

Permanently delete an issue.

Get Issue

issue-get

Read a single issue by key or id.

Get Issue Transitions

issue-get-transitions

List the workflow transitions available from the issue's CURRENT status — the ids `issue-transition` needs.

Search Issues (JQL)

issue-search

Run a JQL query and return the matching issues.

Transition Issue

issue-transition

Move an issue through its workflow. Status is not directly writable — use `issue-get-transitions` to find the id.

Update Issue

issue-update

Update fields on an existing issue. Blank fields are left untouched.

Get Project

project-get

Read a single project by key or id.

List Projects

project-get-many

List every project visible to the connection — the source of project keys.

Get User

user-get

Look up a single user by username or by their internal key.

Search Users

user-search

Find users by name, username or email fragment.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Jira Data Center's real ids.

{
  "manifestVersion": "2",
  "name": "jira-data-center-example",
  "steps": [
    {
      "id": "comment-add",
      "uses": {
        "app": "io.w6w.jira-data-center",
        "action": "comment-add",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "issueKey": "<issueKey>",
        "body": "<body>"
      }
    }
  ]
}

Here are some of the things you can do

  • Add Comment

    perform
    comment-add
  • List Comments

    search
    comment-get-many
  • Assign Issue

    perform
    issue-assign
  • Create Issue

    perform
    issue-create
  • Get Issue

    read
    issue-get

+10 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Jira Data Center, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Jira Data Center. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "comment-add",
  payload: {
    issueKey: "<value>",
    body: "<value>",
    // visibilityRole: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action comment-add --payload '{"issueKey":"<value>","body":"<value>"}'

Give an AI agent Jira Data Center — without giving it Jira Data Center's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.jira-data-center#comment-add",
    "input": {
      "issueKey": "<issueKey>",
      "body": "<body>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Jira Data Center connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Jira Data Center's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Jira Data Center itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Jira Data Center declares its own checks, so its health is a property of the app rather than something the host guesses at.

dependency

Jira instance reachable

This connection's own instance, via its GET /serverInfo. Sends no credential — an instance that requires auth even for this endpoint still counts as reachable.

service

Jira platform status

quota

API quota headroom