Hosted MCP server/Development

Specify MCP server

Hosted at mcp.specify.app·Streamable HTTP

Specify connects coding agents to team documents, decisions, and code context. Agents can search and read workspace documentation through a remote MCP server. Access is read-only by default, with optional permission to create or edit documents. Authentication uses OAuth over HTTP.

mcp.specify.app Streamable HTTP OAuth Server not checked yet Reviewed 2026-11-04
About

Where it fits

Software teams, technical writers, and coding agents that need shared workspace documentation, decisions, and code context.

  • Search workspace docs for an API decision.
  • Read a design document before coding.
  • Create a document with optional edit permission.

A remote MCP server advertises tools to your client. The provider controls the tools, the data they can reach, and the permissions they need. Read the provider's docs before you use it with private data.

Setup

Install it in your client

Choose a client, run the command or use the one-click install, then verify the connection. The endpoint uses Streamable HTTP.

All client guides
  1. 01

    Run this command in your terminal

    This adds Specify as a remote Streamable HTTP server in Claude Code.

    Claude Code
    claude mcp add --transport http specify https://mcp.specify.app/ --scope project
  2. 02

    Verify the connection

    Run claude mcp list, or open /mcp in a Claude Code session.

    Learn more about MCP in Claude Code

More clients, including project and global config files, are in the sidebar.

Connection

Endpoint and configuration

Endpoint
https://mcp.specify.app/
Host
mcp.specify.app
Transport
Streamable HTTP
Authentication
OAuth
Server name
specify
Listing type
Community or directory listing

The installer uses the server name specify. If you add the endpoint by hand, keep the same name so the guide and your config match.

Verification

Check the connection

After you add the server, confirm that the client can see its tools and that one small request returns what the provider describes.

  1. 1
    Open the tool list.

    Restart the client or start a new session. Confirm that specify appears and that the tools match the provider documentation.

  2. 2
    Run one small request.

    Start with: Search workspace docs for an API decision. Check the result before you give the server more access.

  3. 3
    Check permissions.

    Review the OAuth scopes or API-key permissions, then remove the server and revoke its token when you no longer need it.

Server not checked yet

We checked the provider's page, not the MCP connection itself. No MCP sign-in or tool call was attempted. A provider page is linked but was not included in the automated check. Open it before setup.

Troubleshooting

Common failure modes

These are the problems to check first. If the provider changes its endpoint or authentication flow, use its documentation as the source of truth.

  • The sign-in window closes without returning. Allow pop-ups and finish the provider login in the same browser.
  • The server connects but its tools are missing. Remove it, add it again, and approve the scopes the provider lists.
  • Your client does not support Streamable HTTP. Use a client that does, and confirm the provider's current endpoint and transport in its docs.
Safety

Before you connect

Remote means provider access
  • The provider can see the requests and data your agent sends through the server.
  • Review OAuth scopes and API-key permissions. Start read-only if the provider offers it.
  • Use project scope for repository-specific servers; use global scope for personal tools.
  • Remove the server and revoke its token when you stop using it.
Review path

Check the connection before a real task

These guides cover the decisions that a provider description cannot answer: endpoint ownership, scopes, tool access, and a read-only test.

Reference

Provider documentation

Setup requirements, available tools, and rate limits live with the provider. Use the source link as the authority for this server.

Specify documentationhttps://docs.specify.app/en/guides/planning-with-mcp