Blocksight Docs

Model Context Protocol (MCP)

Blocksight runs a hosted Model Context Protocol (MCP) server, so any MCP-compatible client — Claude, ChatGPT, and more — can work with your organization's Blocksight data. Access is granted through OAuth and scoped to the signed-in user's organization.

What you can do

Connected clients use the same tools as the Blocksight assistant:

  • Find project tasks and view the timeline
  • Read decisions and allocations
  • Browse RFPs and proposals, and ask questions about a proposal
  • Search shared memory
  • Make changes — set a decision, update tasks, and edit or set allocation targets

Connection

Add this remote MCP server URL in your client:

https://api.blocksight.xyz/mcp

When the client prompts, sign in with your Blocksight account. Authentication runs over OAuth automatically — there is no API key or client secret to manage.

Connecting grants the client the same access as the signed-in Blocksight account, and all data stays scoped to that user's organization.

Set up your client

Menu labels can vary between client versions — if a label below doesn't match, check your client's own documentation.

Claude (Pro or Max)

  1. Open Customize → Connectors.
  2. Click +, then Add custom connector.
  3. Paste https://api.blocksight.xyz/mcp and click Add.
  4. Sign in with your Blocksight account when prompted.
  5. In a chat, enable the connector from the + menu → Connectors.

Claude (Team or Enterprise)

Only organization Owners can add a custom connector on Team and Enterprise plans.

  1. Open Organization settings → Connectors.
  2. Click Add, hover Custom, then select Web.
  3. Paste https://api.blocksight.xyz/mcp and click Add.
  4. Each member then opens Customize → Connectors and clicks Connect to sign in.

ChatGPT

Custom connectors require Developer Mode (Plus, Pro, Business, or Enterprise).

  1. Open Settings → Connectors → Advanced settings and turn on Developer mode.
  2. Go to Settings → Connectors and click Create.
  3. Enter a name, set the MCP server URL to https://api.blocksight.xyz/mcp, and choose OAuth for authentication.
  4. Click Create and sign in with your Blocksight account.
  5. In a chat, enable the connector from the + menu → More.

Other clients

Add https://api.blocksight.xyz/mcp as a remote (streamable HTTP) MCP server. Many clients accept a JSON config:

{
  "mcpServers": {
    "blocksight": {
      "url": "https://api.blocksight.xyz/mcp"
    }
  }
}

The client runs the OAuth sign-in on first use.

Troubleshooting

  • ChatGPT shows no tools — confirm Developer Mode is on, and re-enable the connector in each new chat from the + menu.
  • Asked for an API key or client ID — the client is likely set to a non-OAuth authentication type. Switch the authentication method to OAuth (or equivalent); signing in is all that's needed, with no API key or client secret to enter.
  • Claude won't let you add a connector — custom connectors need Pro, Max, Team, or Enterprise, and only Owners can add them on Team and Enterprise.

On this page