FeatureOS
FeatureOS

Welcome to our help center

How can we help you today?

FeatureOS MCP Integration

Rashim

6 min read

Connect FeatureOS to your AI assistant (MCP)

FeatureOS supports the Model Context Protocol (MCP), a standard that lets AI assistants connect directly to your tools. Once connected, you and your team can read and update feature requests, comments, votes, changelog entries, help articles, boards, and more, straight from your AI assistant.

So instead of switching tabs to check a post's status or see what's shipping this quarter, you ask your assistant and get a live answer from your FeatureOS workspace.

What you can access

After you connect, your assistant can work with these parts of your workspace. Read tools fetch data; write tools change it. Everything runs as your own FeatureOS user, so it can only do what your role allows.

Feature requests (posts)

  • List feature requests — Search with filters for board, status, tags, submitter or interactor email, date range, and approval status. 14 sort options.

  • Get a feature request — Full details of any post by ID, including all metadata.

  • Create a feature request — New post with a title, board, HTML description, tags, custom status, and an optional Jira link.

  • Update a feature request — Change the title, description, board, status, approval, or scoring (value/effort or RICE).

  • Assign / unassign — Assign a team member to a post by email, or clear the assignee.

  • Add / remove / list tags — Manage the tags on a post.

  • Merge posts — Merge up to 30 duplicate posts into a parent, consolidating votes, comments, and subscribers.

  • List merged posts — See the child posts merged into a given parent.

  • Unmerge a post — Split a merged child back out into its own post.

Comments

  • List comments — Comments on any post, with date-range filtering, up to 50 per page.

  • Get a comment — A single comment by ID.

  • Create a comment — Add a comment to a post.

  • Update a comment — Edit an existing comment.

Votes

  • List upvoters — Who upvoted a post.

  • List downvoters — Who downvoted a post.

Changelog

  • List changelogs — Filter by publish status (published, unpublished, or scheduled) and by language, across 21 languages.

  • Get a changelog — Full details by ID, including labels, linked feature requests, and translations.

  • Create a changelog — Publish or schedule an entry with a title, description, language, and linked feature request IDs.

  • Update a changelog — Edit an existing entry.

  • List / add / remove changelog tags — Manage the labels on a changelog entry.

  • Search changelogs — Find entries by keyword.

Knowledge base

  • List articles — Filter by status, language, collection, assignee, author, privacy, and tag.

  • Get an article — Full content of an article by ID, with its authors, assignees, tags, and collection.

  • List collections — Browse collections, optionally filtered by parent to explore sub-collections.

  • Get a collection — A collection by ID, with its metadata and article count.

Workspace

  • List boards — Your boards, filtered by privacy (public, private, archived), with sort control.

  • List tags — Tags, filtered by source type, source ID, and privacy.

  • List team members — Members by role: admin, member, or CSM.

  • List customers — Your linked customers.

  • Get organization — Details about your FeatureOS organization.

  • Get statuses — The custom statuses configured for your workspace.

How to connect

FeatureOS connects over OAuth. You no longer copy an API key or generate a JWT token. Instead you sign in to FeatureOS in your browser and approve access, the way you would with any app. Your assistant gets a secure token automatically, and you can revoke it any time from your FeatureOS settings.

The server URL is the same everywhere:

https://mcp.featureos.app/mcp

Assistants with built-in remote MCP support (Cursor, and others)

  1. In your assistant's MCP or connectors settings, add a new server and paste the URL above.

  2. Your browser opens the FeatureOS sign-in page. Log in to the workspace you want and approve access.

  3. Back in your assistant, ask something like: "What are the top feature requests in my FeatureOS workspace?" A correct connection returns live results from your boards.

Some assistants (Claude Code, Cursor, and others) configure MCP through a JSON file instead of a settings screen. Add this block to that file:

{
  "mcpServers": {
    "featureos": {
      "type": "http",
      "url": "https://mcp.featureos.app/mcp"
    }
  }
}

The first time it connects, your browser opens the FeatureOS sign-in page for the same OAuth approval. No keys or tokens go in the file.

Claude Desktop

Claude Desktop connects through Connectors. No config file, no extra packages.

  1. Open Claude Desktop and go to Settings → Connectors.

  2. Click Add custom connector.

  3. Enter a name (for example, FeatureOS) and paste the URL:

    https://mcp.featureos.app/mcp

  4. Click Add, then Connect. Your browser opens the FeatureOS sign-in page. Log in and approve access.

  5. Start a new chat and try: "What are the top feature requests in my FeatureOS workspace?"

Example questions

Feature requests

  • "List all feature requests with the status 'Under Review' on the Mobile board."

  • "Show me posts submitted by [email protected] in the last 30 days."

  • "Get the full details of feature request 1234."

  • "Show me the latest 10 comments on post 5678."

  • "Create a feature request titled 'Dark mode support' on the Product board."

  • "Merge posts 4231 and 4232 into post 4230."

Changelog

  • "List all published changelogs."

  • "Show me the scheduled changelog entries."

  • "Create a changelog for our v2.4 release and link it to feature requests 101 and 102."

Knowledge base

  • "List published articles in the Getting Started collection."

  • "Find articles assigned to Sarah about billing."

  • "Get the full content of article 77."

  • "List the sub-collections under the main Help collection."

Workspace

  • "List public boards sorted by latest activity."

  • "Show me the private boards."

  • "List team members with the CSM role."

  • "What tags are available for feature requests on the Feedback board?"

Troubleshooting

  • The sign-in page didn't open — Set a default browser, then quit the assistant fully and reopen to retrigger the connection.

  • Asked to sign in again, or "unauthorized" — Your session expired or was revoked. Open the connector and click Connect to sign in again.

  • No results — Check that you signed in to the right FeatureOS workspace and that your account can see the boards you're asking about.

  • Revoke access — Disconnect an assistant any time from Dashboard → Organization Settings → Advanced in FeatureOS.

Need more help?

Email [email protected] or post on our support board.

Was this helpful?