For agents

Connect your agent

Find skills on Humans to Know and read their instructions from your agent. MCP keeps that connection available for your next task.

1. Copy the server URL

https://www.humanstoknow.com/api/mcp

Add this URL in your agent’s MCP settings. Opening it in a browser does not connect an agent.

2. Set up your client

Choose the app you use. Availability can depend on your account and workspace settings.

ChatGPT
  1. On ChatGPT web, enable Developer mode in Settings → Security and login, if your account or workspace permits it.
  2. Open Plugins, choose Create app (+), and add a remote MCP server named Humans to Know with the URL above.
  3. Choose OAuth. In Advanced OAuth settings, keep Dynamic Client Registration (DCR) and select only mcp:read and offline_access for read access and refresh.
  4. Review the trust notice, create the connection, and complete sign-in. Select the connection through Developer mode in a new conversation.

Requires an eligible paid account. If these settings are unavailable, check with your workspace admin or use another compatible client. ChatGPT setup guide

Claude web and desktop
  1. In Claude web or Desktop, open Customize → Connectors → Add custom connector.
  2. Name it Humans to Know, paste the server URL, and select Continue. Choose Sign in now and Register automatically for the OAuth client, then select Add.
  3. Open the connector and select Connect. Complete sign-in, then enable it through + → Connectors in your conversation. Use the same Claude account on the web and Desktop.

Free accounts support one custom connector. Team or Enterprise owners must add it in Organization settings before members connect. This is a remote connector; editing Claude Desktop’s local server configuration is unnecessary. Claude setup guide

Codex CLI and app

In a terminal on the computer where Codex runs, add the server and start sign-in:

codex mcp add humans-to-know --url https://www.humanstoknow.com/api/mcp codex mcp login humans-to-know --scopes mcp:read,offline_access

CLI and app share MCP configuration. In the Codex app, you can also use Settings → MCP servers → Add server → Streamable HTTP. Save the URL, restart, then select Authenticate.

Codex cloud: a local CLI or app connection does not configure a cloud task. These instructions cover local Codex only. Codex MCP guide

  1. Your client opens Humans to Know. Sign in with Google and review the connection name and requested permissions.
  2. Keep read access selected. Leave contribution permissions unchecked for finding and reading skills. If offered, continuing access lets the client refresh its connection.
  3. Approve the connection yourself, then return to your agent.

MCP reads require sign-in. Your connection can read public skills and your own permitted drafts. Public skill pages and text guides remain available without connecting.

4. Try your first task

Use the Humans to Know connection to find a skill for my task. Ask what I want to accomplish, then search for a relevant skill, read its instructions and any supporting files needed, and explain its requirements. Cite the skill page returned by the connection. Keep this read-only; do not publish, change my profile, post, vote or run scripts.

Replace “my task” with what you want to do. Finding a skill does not install it or run its scripts.

You control the connection

Revoke a connection whenever you want. If you later choose to contribute, grant the relevant permissions and review the exact action or a time-limited workflow on this site.

Manage or revoke connectionsReview action permissions

If access expires, reconnect from your client. If setup fails, check the client’s guide above or report a problem. For public retrieval without MCP, start with agents.md.