Add a teammate to a hosted instance

One path from an instance only you reach to a teammate reading it from their own Claude desktop app. Every step uses what the engine ships today.

Before you start

• Install Revetly from the handout and start the stack
• Serving people who are not you
• Have an HTTPS address that forwards to this machine, and an OIDC issuer both of you reach.

1. Declare who the endpoint answers

1. Add sign-in to this instance:

   revetly init --auth
   

   appended revetly.toml (+<TABLES> — kept what was there)
   

   Revetly writes [auth], a grant for the group engineering, and the endpoint's port, which the engine serves because [auth] is declared.

2. Put the endpoint on the public address

1. Open the configuration page. If it is not open, run revetly config and open the address it prints.

2. Turn on Advanced settings.

3. Go to Instance settings > Authentication and approval.

4. Enter the address your teammate reaches in Resource identifier.

5. Enter your issuer's address in Issuer.

6. Select Save.

   You should see Saved, not applied on those rows.

7. Wait for the endpoint to come back.

3. Let your teammate's client register

1. Read what a hosted client still needs declared:

   revetly doctor --offline
   

   [WARN] connect        Anthropic/ClaudeAI 1.0.0: Settings -> Connectors -> Add custom connector, with the URL <PUBLIC_URL> …
   

   Revetly ends that line with the exact registration_hosts line to write.

2. In revetly.toml at the project root, write the line doctor printed:

   # revetly.toml
   [auth]
   registration_hosts = ["claude.ai"]
   

   Revetly still warns on the ChatGPT line until chatgpt.com is added too.

3. Confirm the issuer registers a client from that host:

   revetly doctor
   

   [PASS] client registration <REGISTRATION_ENDPOINT> registered a client at <HOST> …
   

   If it warns, the issuer still holds the allowlist it imported first.

4. Connect your teammate

1. Create your teammate's account at the issuer, in the group engineering.

2. Send your teammate the connector URL doctor printed.

3. Have your teammate add that URL as a custom connector in the Claude desktop app.

   You should see revetly (as the Claude desktop app shows it)

4. Have your teammate ask for /revetly-ground.

   You should see search_context (as the Claude desktop app shows it)

Troubleshooting

• ChatGPT keeps the tool list from before a change. It caches the list against the connector's URL and never asks again. Add the connector again under a URL that differs, such as the same address with ?v=2 on the end.
• The teammate signs in and every read comes back empty. No grant names a group their token carries. Put them in engineering, or add a grant for their group under [auth.grants].

Next steps

• Connect the Claude desktop app
• Serving people who are not you