Перейти к основному содержимому

Подключение AI-агента к вашему аккаунту

Агент, с которым вы уже работаете, может вести ваши партнёрства без браузера.

Одна команда — и всё работает

Команда открывает 1lev1 в браузере, вы подтверждаете подключение, и ключ автоматически записывается во все установленные у вас агенты — вместе с навыком.

npx 1lev1-mcp

После этого перезапустите агент, чтобы он подхватил новые настройки.

С телефона и из браузера — без терминала

Приложение Claude, claude.ai и Claude Code в браузере подключаются через connector: вставляете один адрес, подтверждаете в браузере — и всё. Ключ копировать не нужно, файл настроек править тоже.

  1. Откройте Настройки → Connectors → Add custom connector.
  2. Задайте имя — например, 1lev1 — и вставьте адрес сервера, приведённый ниже.
  3. Нажмите Connect. Откроется страница 1lev1: войдите и подтвердите подключение.
  4. Готово. Одного подключения хватает и для чата на компьютере, и для приложения на телефоне, и для Claude Code в браузере.

Адрес сервера

https://api.1lev1.com/api/mcp

Подключение создаёт обычный API-ключ в вашем аккаунте. Он виден на странице ключей API и отзывается оттуда — так же, как ключ, созданный из терминала.

Claude Code — через плагин

Если вы работаете в Claude Code, установите навык из маркетплейса, а затем подключите аккаунт командой выше.

/plugin marketplace add Avi-ADAM/1lev1-agent
/plugin install 1lev1@1lev1

Плагин даёт знание, команда подключения — доступ. Нужны оба шага.

О чём можно просить

  • Над чем мне сегодня работать?
  • Запусти таймер на задаче с логотипом.
  • Вчера я работал три часа над дизайном — запиши это.
  • Сколько часов у меня накопилось в этом партнёрстве?
  • Преврати этот репозиторий в партнёрство на нас троих.
  • Что ждёт моего одобрения?

Чего агент не сделает за вас

1lev1 построена на согласии, поэтому агент не совершает действий, затрагивающих другого человека. Вместо этого он готовит форму и отправляет вас подтвердить её на сайте.

  • Не голосует и не подписывает распределение прибыли вместо вас.
  • Не принимает предложения и не меняет положение другого участника в партнёрстве.
  • Не видит данные других пользователей — ключ привязан только к вашему аккаунту.
  • Создание задач и поручений для других по умолчанию отключено и требует явного разрешения.

Что это на самом деле

MCP — открытый протокол, позволяющий AI-агенту подключаться к внешним сервисам. MCP-сервер 1lev1 даёт вашему агенту доступ к вашим задачам, таймерам и партнёрствам — и только к вашим. Устанавливаемый рядом навык объясняет агенту, как устроена платформа: что такое рикма, почему записанные часы — это доля владения и чего он не вправе делать от имени другого человека.

Поддерживаемые агенты

Команда определяет, что у вас действительно установлено, и пишет только туда: Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Roo Code, Continue, Antigravity и VS Code. Файлы настроек, которые она не может разобрать, остаются нетронутыми, а перед каждым изменением создаётся резервная копия.

ChatGPT, Gemini и другие агенты

Сервер говорит на стандартном MCP, поэтому он не только для Claude. Что работает сегодня:

  • ChatGPT — включите Developer mode в настройках, добавьте connector с тем же адресом сервера и подтвердите в браузере. Только на платных тарифах.
  • Gemini CLI и Antigravity — команда подключения выше пишет в них напрямую, как и в любой другой редактор.
  • Gemini Enterprise — администратор добавляет свой MCP-сервер в разделе Connected apps. Там нужны client id и secret вручную — напишите нам, и мы выпустим их для адреса возврата вашей организации.
  • Codex CLI — добавляется вручную в ~/.codex/config.toml, причём ключ хранится в переменной окружения, а не в самом файле.
  • n8n, Zapier или агент, написанный вами — любой MCP-клиент, понимающий Streamable HTTP с заголовком Authorization, работает с тем же адресом.
[mcp_servers.lev1]
url = "https://api.1lev1.com/api/mcp"
bearer_token_env_var = "LEV1_API_KEY"

Потребительское приложение Gemini пока не позволяет добавить MCP-сервер самостоятельно — подключения там открываются только через партнёрства с Google.

Ручная настройка

Если вашего агента нет в списке, сервер можно добавить вручную. Ключ получите командой выше.

Адрес сервера

https://api.1lev1.com/api/mcp
{
  "mcpServers": {
    "1lev1-mcp": {
      "type": "http",
      "url": "https://api.1lev1.com/api/mcp",
      "headers": { "Authorization": "Bearer 1lev1_..." }
    }
  }
}

Безопасность и отключение

  • Ключ — это по сути пароль. Не передавайте его и не сохраняйте в коде, попадающем в git.
  • Повторное подтверждение на сайте заменяет прежний ключ и отзывает старый доступ.

Чтобы отключиться полностью, эта команда удаляет сервер и навык из всех агентов.

npx 1lev1-mcp remove

Эта команда очищает только локальные настройки — сам ключ остаётся действительным. Чтобы аннулировать его, снова выполните команду подключения и подтвердите: она заменит прежний ключ.

Для ИИ-ассистентов

Справочник инструментов

Все инструменты, которые коннектор даёт аккаунту после входа, - в том виде, в каком их возвращает сам сервер, поэтому этот список всегда совпадает с тем, что получает ваш ассистент. Описания инструментов читает ассистент, поэтому они остаются на английском.

Как коннектор обращается с вашей информацией

Чтение

Только читает. Возвращает то, что вы и сами увидели бы на сайте.

findUserProjectsTool

Find my rikmas
  • Только чтение

Find the projects (rikmot) the current user belongs to, newest first, with their creation time. Use this when the user mentions a project by name, wants to navigate to one, or just created one. Results are paginated: when hasMore is true, call again with offset=nextOffset.

Параметры
userId string необязательный
User id to list projects for. Omit to use the authenticated caller.
query string необязательный
Optional search query to filter projects by name (case-insensitive substring).
limit integer необязательный
Page size, default 50.
offset integer необязательный
How many results to skip, default 0.

getProjectDetailsTool

Get rikma details
  • Только чтение

Get the facts about one rikma (project): name, public description, values, links (website, GitHub, Drive, social), members, roles, open missions, missions in progress (and who holds them), open and in-progress resources, and products. Call this before planning or writing anything in a rikma - it is cheap and returns facts, unlike scanProjectDirectionsTool. For a rikma the user is not a member of, only the public face is returned (isMember:false).

Параметры
projectId string обязательный
Rikma (project) id, from findUserProjectsTool.

listProjectResourcesTool

List rikma resources
  • Только чтение
  • Только для участников рикмы

List what a rikma already has and needs: its links (live website, repo, Drive, social), resources in progress (equipment, money, services someone provides) and open resources it is looking for, plus its products. Use it to check whether a rikma already has a website/repo before suggesting one. Members only.

Параметры
projectId string обязательный
Rikma (project) id, from findUserProjectsTool.

getProjectStatsTool

Get rikma stats
  • Только чтение
  • Только для участников рикмы

Get the pulse of one rikma as numbers: members, open missions, missions in progress, open resources, open decisions (votes), active timers, missions finished and hours logged in the last N days, and when anything last happened. Use it to judge whether a rikma is active before planning. Members only; no per-member financial data.

Параметры
projectId string обязательный
Rikma (project) id, from findUserProjectsTool.
days integer необязательный
Window for the "recent" numbers, default 30.

getProjectMembersTool

List rikma members
  • Только чтение
  • Только для участников рикмы

List the people (members) and roles (tafkidim) of a project. Use this to resolve a task assignee - a person or a role - to its ID before calling createTaskTool. For a task with no specific person, pick the roles that fit it here and pass their IDs as tafkidims.

Параметры
projectId string обязательный
ID of the project
query string необязательный
Optional text to filter people or roles by name

getMemberMissionsTool

List a member's missions
  • Только чтение
  • Только для участников рикмы

List a project member's in-progress missions. A task is linked to a mission-in-progress the assignee performs, so call this after choosing the assignee (a person) to pick the missionId to pass to createTaskTool. If no mission in progress covers the work, it is not a task: prepare a mission with prepareMissionTool instead.

Параметры
projectId string обязательный
ID of the project
userId string обязательный
ID of the member (assignee) whose in-progress missions to list

getMissionDetailsTool

Get mission details
  • Только чтение
  • Только для участников рикмы

Get detailed information about a specific mission including tasks, timeline, and current status

Параметры
missionId string обязательный
Mission ID to get details for

listUserMissionsTool

List my missions
  • Только чтение

List user missions with various filtering options

Параметры
filter "all" | "active" | "completed" | "startable" | "stoppable" | "overdue" необязательный
Filter missions by status
projectId string необязательный
Filter by specific project ID (numeric)
projectName string необязательный
Filter by project name
missionName string необязательный
Search for missions by name (partial match)
limit number необязательный
Maximum number of missions to return

findMissionTool

Find a mission
  • Только чтение

Find a specific mission for the user by its name.

Параметры
missionName string обязательный
The name of the mission to find.

getActiveTimersTool

Get running timers
  • Только чтение

Get all currently active timers for the user

Параметры
includeDetails boolean необязательный
Include detailed timer information

getMissionStatsTool

Get mission stats
  • Только чтение

Get statistics about user missions including counts by status, time spent, etc.

Параметры
projectId string необязательный
Get stats for specific project only

searchCatalogTool

Search the catalog
  • Только чтение

Search what the platform already offers publicly: products for sale, open missions (work looking for someone) and open resources (equipment, money, services a rikma needs). Use it before opening a new wish or mission - somebody may already do this. Public data only.

Параметры
query string обязательный
Free text; matched against names, descriptions and rikma names.
kinds "products" | "missions" | "resources"[] необязательный
Which directories to search. Default: all three.
limit integer необязательный
Maximum rows per kind, default 10.

searchContentTool

Search my rikmas
  • Только чтение

Search inside the rikmas the caller belongs to: rikma names and descriptions, open missions, missions in progress, acts, open and in-progress resources, and products. Use it to find something when the rikma is not known - "where was that task about the logo". For public listings of other rikmas use searchCatalogTool instead.

Параметры
query string обязательный
Free text; matched against names and descriptions.
limit integer необязательный
Maximum rows per kind, default 10.

listMyWishesTool

List my wishes
  • Только чтение

List the caller's own wishes (concierge requests): status, coverage, and how many missions and resources each one still needs. Use it to answer "what did I ask for" and to pick the wish a follow-up is about.

Параметры

Без параметров.

getWishDetailsTool

Get wish details
  • Только чтение

Get one wish (concierge request): what it needs broken into missions and resources, its coverage, and the proposals on it. Full detail for the wish owner and for anyone who proposed on it; others see only the public card of an open wish. Accepting or declining a proposal is never done here - open the returned URL and let the person decide.

Параметры
wishId string обязательный
Wish (ratson) id, from listMyWishes or a /concierge or /wish URL.

listMyWishOffersTool

List offers on my wishes
  • Только чтение

The supplier side of the concierge: every proposal the caller is the proposer of - what someone asked them to provide and what they offered, with its status. Use it to answer "who wants something from me". Responding to one happens on its page, not here.

Параметры

Без параметров.

listMyConversationsTool

List my conversations
  • Только чтение

List the conversations (forums) the caller takes part in - one per mission, act, decision, profit split or wish proposal they are involved in, newest first, with the last message. Use it to find the forumId of the thread a request is about.

Параметры
projectId string необязательный
Only conversations of this rikma.
limit integer необязательный
Maximum rows, default 25.

readConversationTool

Read a conversation
  • Только чтение

Read one conversation (forum) the caller takes part in: its messages, newest last, with who wrote each. Use it before answering in a thread, so the reply fits what was already said.

Параметры
forumId string обязательный
Forum id, from listMyConversations.
limit integer необязательный
How many of the most recent messages, default 30.

getSitePagesTool

List site pages
  • Только чтение

Get a structured list of available pages on the 1lev1.com site, useful for navigation.

Параметры

Без параметров.

listRikmaProcessesTool

List rikma processes
  • Только чтение
  • Только для участников рикмы

List a rikma's processes: the open-ended threads it is running - an approach to a partner, a launch, a funding attempt - each with its conversation and the open missions, resources and other objects that have formed out of it. Use it to see what is already in motion before starting something new. Members only.

Параметры
projectId string обязательный
Rikma (project) id.

Подготовка

Возвращает ссылку или предложение либо сохраняет черновик, который никого не обязывает. Утверждают люди на сайте.

createProjectTool

Prepare a new rikma
  • Только чтение

Prepare the "create a Partnership" form (a Partnership is also called a rikma, or "רקמה") and return a link that opens it pre-filled. Nothing is created yet: status is "prepared" until the user opens the link and approves the form. Give the user `url` exactly as returned — do not decode, shorten or rebuild it. A public-benefit or nonprofit initiative is a normal Partnership, not a failed business: every Partnership has a public support page (/project/<id>/support) where anyone can donate to it or fund a specific mission, so the public can cover the members' work hours even when nothing is ever sold.

Параметры
name string обязательный
The name of the new Partnership. Required.
desc string необязательный
A short public description (plain text, one or two sentences).
details string необязательный
Detailed description as raw HTML, e.g. `<h2>Title</h2><p>Body</p>`. Allowed tags: h1, h2, h3, p, ul, ol, li, strong, em, u, s, a, br, blockquote. Do NOT HTML-escape it (send `<p>`, not `&lt;p&gt;`).
url string необязательный
A link to a website related to the project.
vals string[] необязательный
Values and goals of the partnership, as their names. A value may contain commas.
res "feh" | "sth" | "nsh" | "sevend" необязательный
Response time ID: feh (48h), sth (72h), nsh (96h), sevend (1 week).
profit "already" | "week" | "month" | "threeM" | "sixM" | "oneY" | "twoY" | "more" | "never" необязательный
When the Partnership expects to earn from sales: already, week, month, threeM, sixM, oneY, twoY, more, or never. `never` is the correct value for a nonprofit / public-benefit initiative - it means "selling is not the goal", not "it will fail". Such a Partnership is funded through its public support page, where donors can cover the work hours.
ont boolean необязательный
Whether the partnership is continuous (true) or a one-time event (false).

prepareMissionTool

Prepare a mission
  • Только чтение
  • Только для участников рикмы

Prepare the mission creation form and return a link that opens it pre-filled. Use this when the user should review and confirm the mission before it is published. A mission is for work that needs an implementer to be found. If a mission in progress already covers the work, create a task (act) on it with createTaskTool instead. Check the rikma's open missions (getProjectDetailsTool) first: when one already covers the work, point the user to it rather than preparing a duplicate. Mission names are also entries in a platform-wide catalogue where each name is unique; publishing a name that is already there reuses that catalogue entry automatically (the rikma's mission keeps its own description, hours and rate), so never rename a mission just to make it unique. Nothing is created yet: status is "prepared" until the user opens the link and publishes. Give the user `url` exactly as returned — do not decode, shorten or rebuild it. Requires a projectId - use findUserProjects first if not known.

Параметры
projectId string обязательный
ID of the project where the mission will be created.
name string обязательный
Mission name (required).
descrip string необязательный
Mission description as rich HTML - strongly preferred over plain text; a partner decides whether to join from this. Allowed tags: h1, h3, p, ul, ol, li, strong, em, a, br. Recommended shape: a short intro <p>, then a <ul> of concrete deliverables and what done looks like. Do NOT HTML-escape it (send `<p>`, not `&lt;p&gt;`).
skills string[] необязательный
Skill names, free text in the user's language. Matched to the platform catalogue; a skill that does not exist yet is created. Up to 8.
roles string[] необязательный
Role names, free text. Matched to the catalogue; created when missing. Up to 8.
workways string[] необязательный
Work-mode names (how the work is done, e.g. "remote", "on-site"), free text. Matched to the catalogue; created when missing. Up to 8.
nhours number необязательный
Estimated hours.
valph number необязательный
Value per hour.

planProjectWorkTool

Plan rikma work from an idea
  • Меняет данные
  • Только для участников рикмы

Turn a free-text brief into a planning board for a project: proposed missions, chores (acts) and resources, deduplicated against what the project already has. Nothing is created - the tool returns a reviewUrl where the user approves each row in the real form. Use this when the user describes something they want the project to achieve in loose words. If the conversation already holds a concrete breakdown (tasks, scope, decisions), use createPlanBoardTool instead - it saves your rows as written. Requires a projectId (use findUserProjectsTool first if unknown). On failure, `error.retryable` says whether calling again can help.

Параметры
projectId string обязательный
ID of the project to plan for.
text string обязательный
What the user wants to advance, in their own words. At least 20 characters - the richer the brief, the better the breakdown.
title string необязательный
Optional title for the board; otherwise one is suggested.

createPlanBoardTool

Save a planning board
  • Меняет данные
  • Только для участников рикмы

Create a planning board from rows YOU already structured. Use this when the conversation already holds the breakdown - decisions, scope, a task list: your rows are saved as written, with no second model rewriting or dropping them. Nothing is created - every row is a proposal the user approves in the real creation form at the returned reviewUrl. Every row needs a name AND a descrip; rows without one are not saved and come back in `rejected`. Use planProjectWorkTool instead when the user only has a loose idea in free text. Requires a projectId. On failure, `error.retryable` says whether calling again can help.

Параметры
projectId string обязательный
ID of the project to plan for.
title string обязательный
Board title - the direction these rows advance.
descrip string необязательный
One or two plain-text sentences on what this board is for.
items object[] обязательный
The rows, in the order the user should see them. 1 to 40.

scanProjectDirectionsTool

Scan rikma directions
  • Меняет данные
  • Только для участников рикмы

Cheaply scan a project's real current state and propose a few DIRECTIONS for advancing it - strategic angles, not task lists. Use this when the user asks something open-ended like "what should we do next?" or "how do we move this forward?" and has not described a specific goal. These are saved as suggested directions only: nothing is created, and no mission, chore or resource comes out of this call. To break one direction down into concrete missions and resources afterwards, the user opens it on the returned reviewUrl and approves each row there. Requires a projectId. On failure, `error.retryable` says whether calling again can help.

Параметры
projectId string обязательный
ID of the project to scan.

Ваши записи

Меняет только ваши собственные записи - таймеры, профиль, черновики.

timerActionTool

Start or stop a mission timer
  • Меняет данные

Perform actions on user timers (start, stop, pause, resume)

Параметры
action "start" | "stop" | "pause" | "resume" обязательный
The action to perform on the timer
missionId string необязательный
Specific mission ID (optional, will find active timer if not provided)

Ждёт согласия

Передаёт что-то другому участнику, и это ждёт его согласия.

proposeProjectLinkTool

Propose a rikma link
  • Меняет данные
  • Только для участников рикмы

Set or clear one of a rikma's links - its website, GitHub repo, Drive, Discord, Facebook, X or WhatsApp. In a rikma with more than one member, changing the website or the Facebook link opens a decision the members vote on (silence approves it when the rikma clock runs out); the other links change directly. Members only. Check listProjectResourcesTool first - the link may already be there.

Параметры
projectId string обязательный
Rikma (project) id.
kind "website" | "github" | "drive" | "discord" | "facebook" | "x" | "whatsapp" обязательный
Which link to set.
url string обязательный
The URL. Pass an empty string to clear the link.

createTaskTool

Propose a task
  • Меняет данные
  • Только для участников рикмы

Create a task (Act, "מטלה") in a project - the way a member gets something new done. Whenever the user wants something new to happen in a project, offer this option. Choose the shape: - A mission in progress already covers the work: create an act linked to it - assignedUserId = the mission holder, missionId from getMemberMissionsTool. - Nobody in the project does this kind of work, so an implementer must be found: this is not an act - prepare a mission with prepareMissionTool. - No specific person yet: create the act with no assignee and pass tafkidims = the roles that fit it (IDs from getProjectMembersTool). The holders of those roles are notified and one of them picks it up. An act assigned to another person waits for that person to approve it; nobody is bound until they accept. The caller must be a member of the project. Requires a project ID.

Параметры
projectId string обязательный
ID of the project where the task will be created
name string обязательный
Short name/title of the task
description string необязательный
What has to be done and what done looks like, as plain text. Strongly recommended - a title alone is hard to act on.
link string необязательный
Optional URL related to the task
assignedUserId string необязательный
ID of the person (project member) to assign this task to - usually the holder of the mission it belongs to. Use getProjectMembersTool to resolve a name to an ID. Mutually exclusive with tafkidims.
tafkidims string[] необязательный
IDs of the roles (tafkidim) that fit the task, when no specific person is chosen; a holder of one of them picks it up. Use getProjectMembersTool to resolve role names to IDs. Mutually exclusive with assignedUserId.
missionId string необязательный
ID of the mission in progress (mesimabetahaliches) this task belongs to, from getMemberMissionsTool. Goes with assignedUserId.
hashivut "white" | "green" | "yellow" | "red" необязательный
Urgency level of the task
dateS string необязательный
Start date (ISO format)
dateF string необязательный
End date (ISO format)

Общение

Видно другим от вашего имени и никого не обязывает.

postConversationMessageTool

Post to a conversation
  • Меняет данные

Post a message, as the user, in a conversation (forum) they take part in - an update on a mission, an answer in a decision thread, a note on a profit split. The other participants are notified. Use it ONLY when the user asked to say or record something; never to think out loud, and never to agree or refuse on their behalf (approving a decision, a split or a proposal is always their own click). The message is marked as written through an agent.

Параметры
forumId string обязательный
Forum id, from listMyConversations.
message string обязательный
The message, in the user's own words and language. Plain text.

openRikmaConversationTool

Open the rikma conversation
  • Меняет данные
  • Только для участников рикмы

Get the rikma's own general conversation - the one thread that belongs to the whole rikma rather than to a single mission, act or decision. It is created the first time someone opens it. Use it for "what are we doing next" talk; anything about a specific mission, decision or profit split belongs in that thing's own thread, where it stays on record. Returns a forumId for readConversation and postConversationMessage. Members only.

Параметры
projectId string обязательный
Rikma (project) id.

startProcessTool

Start a process
  • Меняет данные
  • Только для участников рикмы

Start a process in a rikma: a named thread with its own conversation, for something that is not yet a mission or a resource - approaching an organisation, preparing a launch, chasing funding. The description becomes the first message, so a half-formed idea can be written in plain words and take shape later: as it becomes concrete, the open missions and resources it needs are created in the normal way and attached with attachToProcess. Members only. Use it when the user wants to record something the rikma is pursuing, not to file your own notes.

Параметры
projectId string обязательный
Rikma (project) id.
name string обязательный
Short name, e.g. "Approach: city community centre".
description string необязательный
The raw text, in the user's own words: what this is, who it involves, what is hoped for.

attachToProcessTool

Attach to a process
  • Меняет данные
  • Только для участников рикмы

Attach an existing object - an open mission, an open resource, a mission in progress, or a mission/resource still being voted on - to a process, so what the rikma is pursuing and what it is actually doing about it stay connected. It does not create the object: create it first (prepareMissionTool, createTaskTool, or the URL the tool returns), then attach it.

Параметры
projectId string обязательный
Rikma (project) id.
processId string обязательный
Process id, from listRikmaProcesses or startProcess.
entityType "openMission" | "openMashaabim" | "mesimabetahalich" | "maap" | "pendm" | "pmash" обязательный
What kind of object is being attached.
entityId string обязательный
Id of that object.
name string необязательный
Its name, for the process timeline.

Общая запись

Создаёт обязательства для других людей. Выключено, если ключу не выдана область mcp:write.

createMissionTool

Create an open mission
  • Меняет данные
  • Только для участников рикмы
  • Нужна область mcp:write

Create a new mission directly in a project. Resolves skill/role/workway names to platform IDs via vector search (Pinecone), creating new vocabulary entries when needed. Use prepareMissionTool instead when you want the user to review the mission before publishing.

Параметры
projectId string обязательный
ID of the project where the mission will be created.
missionName string обязательный
Name of the mission (required).
descrip string необязательный
Mission description (plain text or HTML).
skills string[] необязательный
Skill names needed for the mission.
roles string[] необязательный
Role/position names for the mission.
workways string[] необязательный
Work mode names (remote, onsite, hybrid…).
nhours number необязательный
Estimated hours.
valph number необязательный
Value per hour (₪/$ per hour).
iskvua boolean необязательный
True if this is a recurring monthly mission.
dateStart string необязательный
Start date (ISO 8601).
dateEnd string необязательный
End date (ISO 8601).
assignedUserId string необязательный
User ID to assign the mission to (omit for open/voted).
checklist object[] необязательный
Optional checklist tasks for the mission.

Конфиденциальность

Новое желание